Freigeben über

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

  • Artikel

Der SQLXMLOLEDB-Anbieter ist ein OLE DB-Anbieter, der Microsoft SQLXML-Funktionalität durch ADO (ActiveX Data Objects) verfügbar macht. Der Anbieter kann Befehle jedoch nur im ADO-Modus zum Schreiben in einen Ausgabedatenstrom ausführen. Der SQLXMLOLEDB-Anbieter ist kein Rowsetanbieter. Wenn Sie einen Befehl ausführen, müssen Sie das adExecuteStream-Flag angeben, das ADO anweist, den angegebenen Ausgabedatenstrom zu verwenden.

Im folgenden Beispiel wird die Syntax für den Execute-Befehl, in dem das adExecuteStream-Flag angegeben wird, veranschaulicht:

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

Anbieterspezifische SQLXMLOLEDB-Eigenschaften

Der SQLXMLOLEDB-Anbieter stellt die folgenden anbieterspezifischen Verbindungseigenschaften zur Verfügung.

Verbindung

Eigenschaft

Standardwert

(ggf.)

Beschreibung

Data Provider

 

Stellt die PROGID des OLE DB-Anbieters zur Verfügung, durch die SQLXMLOLEDB die Befehle ausführt. Ab SQLXML 4.0 und SQL Server 2005 ist dieser Anbieter in SQL Server Native Client enthalten. Daher ist dieser Eigenschaftswert auf "SQLNCLI11" beschränkt. Weitere Informationen finden Sie unter Programmierung für SQL Server Native Client.

Der SQLXMLOLEDB-Anbieter stellt die folgenden anbieterspezifischen Befehlseigenschaften zur Verfügung.

Befehl

Eigenschaft

Standardwert

(ggf.)

Beschreibung

Base Path

""

Gibt den Basispfad der Datei an. Der Basispfad der Datei gibt den Speicherort der XSL-Dateien (XML Stylesheet Language) oder der Zuordnungsschemadateien an. Der Basispfad der Datei löst außerdem die relativen Pfade der XSL- oder Zuordnungsschemadateien auf, die in der XSL-Eigenschaft oder der Mapping Schema-Eigenschaft angegeben wurden.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Ausführen von XPath-Abfragen (SQLXMLOLEDB-Anbieter).

ClientSideXML

FALSE

Legen Sie diese Eigenschaft auf True fest, wenn die Konvertierung des Rowsets in XLM statt auf dem Server auf dem Client erfolgen soll. Dies ist nützlich, wenn Sie die Ladeleistungslast auf die mittlere Ebene verschieben möchten.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Ausführen von SQL-Abfragen (SQLXMLOLEDB-Anbieter) oder Ausführen von Vorlagen, die SQL-Abfragen enthalten (SQLXMLOLEDB-Anbieter).

Content Type

 

Gibt den Ausgabeinhaltstyp zurück. Dies ist eine schreibgeschützte Eigenschaft.

Diese Eigenschaft stellt dem Browser Informationen über den Inhaltstyp (z. B. TEXT/XML, TEXT/HTML, image/jpeg usw.) zur Verfügung. Der Wert dieser Eigenschaft entspricht dem content-type-Feld, das als Teil des HTTP-Headers an den Browser gesendet wird. Der Header enthält den MIME-Typ (Multipurpose Internet Mail Extensions) des als Textkörper gesendeten Dokuments.

Mapping Schema

NULL

Wenn eine Clientanwendung eine XPath-Abfrage für ein Zuordnungsschema (XDR oder XSD) ausführt, wird mit dieser Eigenschaft der Name des Zuordnungsschemas angegeben.

Der Pfad, der angegeben wird, kann relativ (xyz/abc/MySchema.xml) oder absolut (C:\MyFolder\abc\MySchema.xml) sein.

Wird ein relativer Pfad angegeben, wird der von der Base Path-Eigenschaft angegebene Basispfad zur Auflösung des relativen Pfads verwendet. Wurde in der Base Path-Eigenschaft kein Pfad angegeben, bezieht sich der relative Pfad auf das aktuelle Verzeichnis.

Beim Festlegen eines Werts für die Mapping Schema-Eigenschaft 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 den HTTP- und den HTTPS-Server über einen Proxyserver konfigurieren. Führen Sie dazu das Hilfsprogramm Proxycfg.exe aus. Weitere Informationen finden Sie im Abschnitt über das Verwenden des WinHTTP-Proxy-Konfigurationshilfsprogramms in der MSDN Library.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Ausführen von XPath-Abfragen (SQLXMLOLEDB-Anbieter).

Namespaces

 

Diese Eigenschaft ermöglicht die Ausführung von XPath-Abfragen, die Namespaces verwenden. Ein Beispiel für die Verwendung dieser Eigenschaft 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. Beispielsweise sollen keine URL-Verweise auf Dateien oder absolute Pfade für Dateien (wie externe Websites) zugelassen werden. Oder es sollen keine Abfragen in den Vorlagen zulässig sein.

Der Eigenschaft können folgende Werte 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 über diese Werte sind in der nächsten Tabelle enthalten.

XML-Stamm

 

Diese Eigenschaft wird verwendet, um ein Stammtag für das resultierende XML zu definieren. Wenn Sie beispielsweise SQL-Abfragen für die Datenbank ausführen und das resultierende XML-Dokument kein einzelnes Stammelement hat, wird der Wert der Eigenschaft dazu verwendet, dem Dokument ein einzelnes Stammelement hinzuzufügen.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Ausführen von SQL-Abfragen (SQLXMLOLEDB-Anbieter).

XSL

 

Mit dieser Eigenschaft wird der XSL-Dateiname angegeben, wenn die XSL-Transformation auf das von der Abfrage zurückgegebene XML-Dokument angewendet werden soll.

Der Pfad, der angegeben wird, kann relativ (xyz/abc/MyXSL.xsl) oder absolut (C:\MyFolder\abc\MyXSL.xsl) sein.

Wird ein relativer Pfad angegeben, wird der von der Base Path-Eigenschaft angegebene Basispfad zur Auflösung des relativen Pfads verwendet. Wurde in der Base Path-Eigenschaft kein Pfad angegeben, bezieht sich der relative Pfad auf das aktuelle Verzeichnis.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter Applying an XSL Transformation (SQLXMLOLEDB Provider).

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

Eigenschaftswert

Beschreibung

STREAM_FLAGS_DISALLOW_URL

URLs werden nicht zum Zuordnen von Schemas oder XSL akzeptiert.

STREAM_FLAGS_DISALLOW_ABSOLTE_PATH

Ein für das Zuordnungschema oder für XSL angegebener Pfad muss sich auf den Basispfad der Vorlage selbst beziehen.

STREAM_FLAGS_DISALLOW_QUERY

Abfragen sind in einer Vorlage nicht zulässig.

STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA

Das Zuordnungsschema wird nicht zwischengespeichert. Dieser Eigenschaftswert ist während der Datenbankentwicklungsphase nützlich, wenn Datenbankschemas Änderungen unterliegen.

STREAM_FLAGS_DONTCACHETEMPLATE

Vorlagen werden nicht zwischengespeichert.

STREAM_FLAGS_DONTCACHEXSL

XSL wird nicht zwischengespeichert.