Einführung in den SQLXMLOLEDB-Anbieter (SQLXML 4.0)

Der SQLXMLOLEDB-Anbieter ist ein OLE DB-Anbieter, der Microsoft SQLXML-Funktionen über ActiveX Data Objects (ADO) verfügbar macht. Der Anbieter kann Jedoch Befehle nur im Modus "Schreiben in einen Ausgabedatenstrom" von ADO ausführen. Der SQLXMLOLEDB-Anbieter ist kein Rowsetanbieter. Wenn Sie einen Befehl ausführen, müssen Sie das adExecuteStream-Flag angeben, das ADO angibt, um den angegebenen Ausgabedatenstrom zu verwenden.

Das folgende Beispiel zeigt die Syntax für den Execute-Befehl, in dem das adExecuteStream-Flag angegeben wird:

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

Anbieterspezifische SQLXMLOLEDB-Eigenschaften

Der SQLXMLOLEDB-Anbieter macht die folgende anbieterspezifische Verbindungseigenschaft verfügbar.

Verbindung Eigentum	Standard (falls vorhanden)	BESCHREIBUNG
Datenanbieter		Stellt die PROGID des OLE DB-Anbieters bereit, über den SQLXMLOLEDB die Befehle ausführt. Ab SQLXML 4.0 und SQL Server 2005 ist dieser Anbieter im SQL Server Native Client enthalten; Daher ist dieser Eigenschaftswert auf "SQLNCLI11" beschränkt. Weitere Informationen finden Sie unter SQL Server Native Client Programming.

Der SQLXMLOLEDB-Anbieter macht die folgenden anbieterspezifischen Befehlseigenschaften verfügbar.

Befehl Eigentum	Standard (falls vorhanden)	BESCHREIBUNG
Basispfad	""	Gibt den Basisdateipfad an. Der Basisdateipfad wird verwendet, um den Speicherort der XML Stylesheet Language (XSL) oder Zuordnungsschemadateien anzugeben. Der Basisdateipfad wird auch verwendet, um die relativen Pfade von XSL- oder Zuordnungsschemadateien aufzulösen, die in den XSL- oder Zuordnungsschemaeigenschaften angegeben wurden. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Ausführen von XPath-Abfragen (SQLXMLOLEDB-Anbieter).For an example in which this property is used, see Executing XPath Queries (SQLXMLOLEDB Provider).
ClientSideXML	Falsch	Legen Sie diese Eigenschaft auf "True" fest, wenn der Prozess der Konvertierung des Rowsets in XML auf dem Client statt auf dem Server erfolgen soll. Dies ist nützlich, wenn Sie die Leistungslast auf die mittlere Ebene verschieben möchten. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Ausführen von SQL-Abfragen (SQLXMLOLEDB-Anbieter) oder Ausführen von Vorlagen, die SQL-Abfragen (SQLXMLOLEDB-Anbieter) enthalten.
Inhaltstyp		Gibt den Ausgabeinhaltstyp zurück. Dies ist eine READ ONLY-Eigenschaft. Diese Eigenschaft stellt dem Browser Informationen zum Inhaltstyp bereit (z. B. TEXT/XML, TEXT/HTML, image/jpeg usw.). Der Wert dieser Eigenschaft wird zum Inhaltstypfeld , das als Teil des HTTP-Headers an den Browser gesendet wird, der den MIME-Typ (Multipurpose Internet Mail Extensions) des Dokuments enthält, das als Textkörper gesendet wird.
Zuordnungsschema	NULL	Wenn eine Clientanwendung eine XPath-Abfrage für ein Zuordnungsschema (XDR oder XSD) ausführt, wird diese Eigenschaft verwendet, um den Namen des Zuordnungsschemas anzugeben. Der angegebene Pfad kann relativ (xyz/abc/MySchema.xml) oder absolut (C:\MyFolder\abc\MySchema.xml) sein. Wenn ein relativer Pfad angegeben wird, wird der Basispfad, der von der Base Path-Eigenschaft angegeben wird, verwendet, um den relativen Pfad aufzulösen. Wenn in der Base Path-Eigenschaft kein Pfad angegeben wurde, ist der relative Pfad relativ zum aktuellen Verzeichnis. Wenn Sie einen Wert für die Zuordnungsschemaeigenschaft angeben, können Sie einen lokalen Verzeichnispfad oder eine URL (http://...) angeben. Wenn Sie eine URL angeben, müssen Sie WinHTTP für den Zugriff auf HTTP- und HTTPS-Server über einen Proxyserver konfigurieren. Sie können dies tun, indem Sie das hilfsprogramm Proxycfg.exe ausführen. Weitere Informationen finden Sie unter "Using the WinHTTP Proxy Configuration Utility" in der MSDN Library. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Ausführen von XPath-Abfragen (SQLXMLOLEDB-Anbieter).For an example in which this property is used, see Executing XPath Queries (SQLXMLOLEDB Provider).
Namespaces		Diese Eigenschaft ermöglicht die Ausführung von XPath-Abfragen, die Namespaces verwenden. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Ausführen von XPath-Abfragen mit Namespaces (SQLXMLOLEDB-Anbieter).
ss Stream Flags		Diese Eigenschaft wird verwendet, um bestimmte Arten von Sicherheitseinschränkungen anzugeben. Sie möchten z. B. keine URL-Verweise auf Dateien oder absolute Pfade zu Dateien zulassen (z. B. externe Websites). Oder Sie möchten Abfragen in den Vorlagen möglicherweise nicht zulassen. Die Eigenschaft kann diesen Werten zugewiesen werden: 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 Weitere Informationen zu diesen Werten finden Sie in der nächsten Tabelle.
XML-Stamm		Diese Eigenschaft wird verwendet, um ein Stammtag für den resultierenden XML-Code zu definieren. Wenn Sie beispielsweise SQL-Abfragen für die Datenbank ausführen und das resultierende XML-Dokument kein einzelnes Stammelement aufweist, wird der Wert der Eigenschaft verwendet, um dem Dokument ein einzelnes Stammelement hinzuzufügen. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Ausführen von SQL-Abfragen (SQLXMLOLEDB-Anbieter).For an example in which this property is used, see Executing SQL Queries (SQLXMLOLEDB Provider).
xsl		Diese Eigenschaft wird verwendet, um den XSL-Dateinamen anzugeben, wenn Sie die XSL-Transformation auf das von der Abfrage zurückgegebene XML-Dokument anwenden möchten. Der angegebene Pfad kann relativ (xyz/abc/MyXSL.xsl) oder absolut (C:\MyFolder\abc\MyXSL.xsl) sein. Wenn ein relativer Pfad angegeben wird, wird der Basispfad, der von der Base Path-Eigenschaft angegeben wird, verwendet, um den relativen Pfad aufzulösen. Wenn in der Base Path-Eigenschaft kein Pfad angegeben wurde, ist der relative Pfad relativ zum aktuellen Verzeichnis. Ein Beispiel, in dem diese Eigenschaft verwendet wird, finden Sie unter Anwenden einer XSL-Transformation (SQLXMLOLEDB-Anbieter).

Die folgende Tabelle enthält Beschreibungen der Werte der ss Stream Flags-Eigenschaft.

Immobilienwert	BESCHREIBUNG
STREAM_FLAGS_DISALLOW_URL	URLs werden für Zuordnungsschemas oder XSL nicht akzeptiert.
STREAM_FLAGS_DISALLOW_ABSOLTE_PATH	Ein Pfad, der für ein Zuordnungsschema oder für XSL angegeben ist, muss relativ zum Basispfad der Vorlage selbst sein.
STREAM_FLAGS_DISALLOW_QUERY	Abfragen sind in einer Vorlage nicht zulässig.
STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA	Das Zuordnungsschema ist nicht zwischengespeichert. Dieser Eigenschaftswert ist während der Datenbankentwicklungsphase nützlich, wenn Datenbankschemas geändert werden können.
STREAM_FLAGS_DONTCACHETEMPLATE	Vorlagen werden nicht zwischengespeichert.
STREAM_FLAGS_DONTCACHEXSL	XSL ist nicht zwischengespeichert.