Udostępnij przez


Wprowadzenie do dostawca SQLXMLOLEDB (SQLXML 4.0)

Dostawca SQLXMLOLEDB jest dostawcą OLE DB, który umożliwia uzyskanie dostępu do Microsoft Funkcja SQLXML za pośrednictwem obiektów ActiveX Data Objects (ADO). Dostawca może wykonać polecenia tylko w trybie "zapisu do strumień wyjściowy „ ADO.Dostawca SQLXMLOLEDB nie jest dostawcą zestawu zestaw wierszy.Po wykonaniu polecenia, należy określić adExecuteStream Flaga, która określa, że obiektów ADO do strumień wyjściowy, które zostały określone za pomocą.

W poniższym przykładzie przedstawiono składnię Execute polecenia, w którym adExecuteStream Flaga jest określona:

Dim oTestCommand As New ADODB.Command
...
oTestCommand.Properties("Output Stream").Value = oTestStream
oTestCommand.Execute , , adExecuteStream
...

Właściwości specyficzne dla dostawca SQLXMLOLEDB

Dostawca SQLXMLOLEDB udostępnia następujące właściwość połączenia specyficznym dla dostawcy.

Połączenia

Właściwość

Default

(jeśli istnieje)

Description

Data Provider

 

Zawiera PROGID dostawca OLE DB, przez które SQLXMLOLEDB wykonuje polecenia.Począwszy od SQLXML 4.0 i SQL Server 2005, ten dostawca jest zawarty w SQL ServerMacierzysta klient; dlatego wartość tej właściwość jest ograniczona do "SQLNCLI10". Aby uzyskać więcej informacji zobaczProgram SQL Server 2008 Native klient Programming.

Dostawca SQLXMLOLEDB udostępnia następujące właściwości polecenia specyficzne dla dostawcy.

Polecenie

Właściwość

Default

(jeśli istnieje)

Description

Base Path

""

Określa ścieżka do pliku podstawowego.Aby określić lokalizację XML język arkusza stylów (XSL) lub pliki mapowania schematu używana jest ścieżka pliku podstawowego.Ścieżka pliku podstawowego jest także używany do rozpoznawania ścieżki względne XSL lub mapowanie schematu pliki, które zostały określone w XSL lub Mapping Schema właściwości.

Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Wykonywanie kwerendy XPath (Dostawca SQLXMLOLEDB).

ClientSideXML

Fałsz

Ustaw dla tej właściwość wartość true, jeśli chcesz, aby proces konwersji do formatu XML występuje klient, a nie na serwerze zestaw wierszy.Jest to przydatne, gdy użytkownik chce przenieść obciążenia wydajności warstwa środkowa.

Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Wykonywanie kwerendy SQL (Dostawca SQLXMLOLEDB) lub Wykonywanie szablony zawierające kwerendy SQL (Dostawca SQLXMLOLEDB).

Content Type

 

Zwraca typ zawartości, danych wyjściowych.Jest to właściwość READ ONLY.

Właściwość ta zawiera informacje do przeglądarki o typie zawartości (takie jak TEXT/XML, TEXT/HTML, obraz/jpeg i tak dalej).Wartość tej właściwość staje się Typ zawartości pole, które są wysyłane do przeglądarki jako część nagłówka HTTP, który zawiera typ MIME (Multipurpose Internet Mail Extensions) są wysyłane jako treść dokumentu.

Mapping Schema

WARTOŚCI NULL

Jeśli aplikacja kliencka wykonuje kwerendę XPath ze schematem mapowania (XDR lub XSD), właściwość ta służy do określania nazwy schematu mapowania.

Ścieżka, która została określona może być względna (xyz/abc/MySchema.xml) lub bezwzględną (C:\MyFolder\abc\MySchema.xml).

Jeśli zostanie określona ścieżka względna, ścieżki bazowej, określonego przez parametr Base Path Właściwość jest używana w celu rozwiązania ścieżki względnej. Jeśli ścieżka nie została określona w Base Path Właściwość, ścieżka względna jest względna w stosunku do bieżącego katalogu.

In specifying a value for the Mapping Schema property, you can specify a local directory path or a URL (http://...).Jeśli określony adres URL, należy skonfigurować usługi WinHTTP z serwerami HTTP i HTTPS dostępu za pośrednictwem serwera proxy.Można to zrobić, uruchamiając narzędzie proxycfg.exe.Aby uzyskać więcej informacji zobacz „ Using the WinHTTP Proxy narzędzia konfiguracja"w bibliotece MSDN.

Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Wykonywanie kwerendy XPath (Dostawca SQLXMLOLEDB).

obszary nazw

 

Właściwość ta umożliwia wykonanie kwerendy XPath, używające obszarów nazw.Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Wykonywanie kwerend XPath za pomocą obszarów nazw (Dostawca SQLXMLOLEDB).

ss flagi strumienia

 

Ta właściwość jest używana do określenia szczególnych rodzajów ograniczeń zabezpieczeń.Na przykład nie może być adres URL odwołania do plików lub bezwzględnej ścieżki do plików (na przykład w witrynach zewnętrznych).Lub nie można zezwolić na kwerendy w szablonach.

Wartości te można przypisywać właściwość:

1 = STREAM_FLAGS_DISALLOW_URL 2 = STREAM_FLAGS_DISALLOW_ABSOLUTE_PATH 4 = STREAM_FLAGS_DISALLOW_QUERY 8 = STREAM_FLAGS_ DONTCACHEMAPPINGSCHEMA 16 = STREAM_FLAGS_DONTCACHETEMPLATE 32 = STREAM_FLAGS_DONTCACHEXSL

Aby uzyskać dodatkowe informacje o tych wartościach znajduje się w następnej tabela.

głównego danych XML

 

Ta właściwość służy do definiowania tag katalogu głównego dla wynikowego pliku XML.Na przykład jeśli wykonać kwerendy SQL w bazie danych, a wynikowy dokument XML zawiera element nie jednego katalogu głównego, wartość właściwość służy do dodawania elementu głównego pojedynczego do dokumentu.

Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Wykonywanie kwerendy SQL (Dostawca SQLXMLOLEDB).

XSL

 

Ta właściwość jest używana do określenia nazwy pliku XSL, można zastosować transformacja XSL do dokumentu XML zwróconych przez kwerendę.

Ścieżka, która została określona może być względna (xyz/abc/MyXSL.xsl) lub bezwzględną (C:\MyFolder\abc\MyXSL.xsl).

Jeśli zostanie określona ścieżka względna, ścieżki bazowej, określonego przez parametr Base Path Właściwość jest używana w celu rozwiązania ścieżki względnej. Jeśli ścieżka nie została określona w Base Path Właściwość, ścieżka względna jest względna w stosunku do bieżącego katalogu.

Aby zapoznać się z przykładem, w którym ta właściwość jest używana zobacz Applying an XSL Transformation (SQLXMLOLEDB Provider).

Poniższa tabela zawiera opisy ss Stream Flags wartości właściwość.

Wartość właściwość

Description

STREAM_FLAGS_DISALLOW_URL

Adresy URL nie są akceptowane mapowania schematów lub XSL.

STREAM_FLAGS_DISALLOW_ABSOLTE_PATH

ścieżka określonej dla schematu mapowania lub XSL musi być względem ścieżka bazowej samego szablonu.

STREAM_FLAGS_DISALLOW_QUERY

Kwerendy nie są dozwolone w szablonie.

STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA

Mapowanie schematu nie są buforowane.Wartość tej właściwość jest użyteczne podczas fazy opracowywania bazy danych, gdy schematy bazy danych podlegają zmianom.

STREAM_FLAGS_DONTCACHETEMPLATE

Szablony nie są buforowane.

STREAM_FLAGS_DONTCACHEXSL

XSL nie jest buforowana.