Udostępnij przez


Wprowadzenie do dostawcy SQLXMLOLEDB (SQLXML 4.0)

dostawca OLE DB, który udostępnia jest dostawcą SQLXMLOLEDB Microsoft SQLXML funkcji za pośrednictwem obiektów ActiveX Data Objects (ADO).Jednak dostawca może wykonać polecenia tylko w "zapisu do strumień wyjściowy" Tryb ADO.Dostawca SQLXMLOLEDB nie jest dostawcą zestawu zestaw wierszy.Gdy zostanie wykonać polecenia, należy określić adExecuteStream flagi instruuje ADO, aby użyć strumień wyjściowy, które zostały określone.

W poniższym przykładzie pokazano składnię Execute polecenia, w którym adExecuteStream Określona flaga:

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

Właściwości specyficzne dla dostawcy SQLXMLOLEDB

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

Połączenie

właściwość

Default

(jeśli ma zastosowanie)

Opis

Data Provider

 

Zawiera identyfikator PROGID dostawca OLE DB, przez który SQLXMLOLEDB wykonuje polecenia.Począwszy od SQLXML 4.0 i SQL Server 2005, ten dostawca jest zawarty w SQL Server Native Client; Dlatego wartość tej właściwość jest ograniczone do "sqlncli10".Aby uzyskać więcej informacji, zobacz SQL Server 2008 R2 Native Client Programming.

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

Polecenia

właściwość

Default

(jeśli ma zastosowanie)

Opis

Base Path

""

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

Na przykład, w którym ta właściwość jest używana, zobacz Wykonywanie kwerend XPath (Dostawca SQLXMLOLEDB).

ClientSideXML

Fałsz

Ustaw tę właściwość na wartość True, jeśli chcesz, aby proces konwersji zestawu zestaw wierszy XML występują klient, a nie na serwerze.Jest to przydatne, gdy chcesz przenieść obciążenia wydajności w warstwie środkowej.

Na przykład, w którym ta właściwość jest używana, zobacz Wykonywanie kwerend SQL (Dostawca SQLXMLOLEDB) lub Wykonywanie szablonów zawierających 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 typ zawartości (takie jak tekst i XML, tekst i HTML, image/jpeg i tak dalej).Wartość tej właściwość staje się content-type pole, które jest 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

NULL

Jeśli klient aplikacja wykonuje kwerendę XPath schematem mapowania (XDR lub XSD), ta właściwość jest używana do określenia nazwy schematu mapowania.

ścieżka określonej może być względna (xyz/abc/MySchema.xml) lub bezwzględny (C:\MyFolder\abc\MySchema.xml).

Jeśli określono ścieżka względnej ścieżka bazowej określonej przez Base Path właściwość jest używany do rozpoznawania ścieżka względnej.Jeśli ścieżka nie została określona w Base Path właściwość, jest względna ścieżka względem 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ślono adres URL, należy skonfigurować usługi WinHTTP z serwerami HTTP i HTTPS dostępu za pośrednictwem serwera proxy.Można to zrobić przez wykonanie narzędzia Proxycfg.exe.Aby uzyskać więcej informacji zobacz "Przy użyciu usługi WinHTTP Proxy Configuration Utility" w bibliotece MSDN.

Na przykład, w którym ta właściwość jest używana, zobacz Wykonywanie kwerend XPath (Dostawca SQLXMLOLEDB).

przestrzenie nazw

 

Właściwość ta umożliwia wykonywanie kwerend XPath, korzystających z obszarów nazw.Na przykład, w którym ta właściwość jest używana, zobacz Wykonywanie kwerend XPath z przestrzeniami 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że chcesz zezwolić kwerend 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

Dodatkowe informacje na temat tych wartości podano w następnej tabela.

główny XML

 

Ta właściwość służy do definiowania główny tag XML, wynikowe.Na przykład jeżeli wykonać kwerendy SQL do bazy danych i wynikowy dokument XML zawiera element nie pojedynczego głównego, wartość właściwość służy do dodawania elementu głównego pojedynczego do dokumentu.

Na przykład, w którym ta właściwość jest używana, zobacz Wykonywanie kwerend SQL (Dostawca SQLXMLOLEDB).

XSL

 

Ta właściwość jest używana do określ nazwę pliku XSL, gdy chcesz zastosować transformacja XSL do dokumentu XML zwróconych przez kwerendę.

ścieżka określonej może być względna (xyz/abc/MyXSL.xsl) lub bezwzględny (C:\MyFolder\abc\MyXSL.xsl).

Jeśli określono ścieżka względnej ścieżka bazowej określonej przez Base Path właściwość jest używany do rozpoznawania ścieżka względnej.Jeśli ścieżka nie została określona w Base Path właściwość, jest względna ścieżka względem bieżącego katalogu.

Na przykład, 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ści

Opis

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 jest buforowana.Wartość tej właściwość jest przydatne 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.