Verwendung von XML-Vorlagen (MSSQL-Handbuch)

Hier ist die allgemeine Form einer Vorlage, die zeigt, wie SQL-Abfragen und XPath-Abfragen angegeben werden:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql" 
       sql:xsl=&#39;XSL FileName&#39; > 
  <sql:header> 
    <sql:param>..</sql:param> 
    <sql:param>..</sql:param>...n 
  </sql:header> 
  <sql:query> 
    sql statement(s) 
  </sql:query> 
  <sql:xpath-query mapping-schema="SchemaFileName.xml"> 
    XPath query 
  </sql:xpath-query> 
</ROOT>

Jedes Element in der Vorlage ist optional. Die Elemente

, , , und das Attributzuordnungsschema sind im SQL-Namespace definiert. Daher muss xmlns:sql="urn:schemas-microsoft-com:xml-sql" im Namespace deklariert werden. Sie können dem Namespace einen beliebigen Namen geben; SQL ist nur ein Alias.

Geben Sie dieses Tag an, um ein einzelnes Element der obersten Ebene (auch Root-Tag genannt) des resultierenden XML-Dokuments bereitzustellen. Das -Tag kann ein beliebiger Name sein.

Dieses Tag wird zum Speichern aller Headerwerte verwendet. In der aktuellen Implementierung kann in diesem Tag nur das Element angegeben werden. wird als Einschluss-Tag verwendet, sodass Sie mehrere Parameter definieren können. Alle Parameterdefinitionen befinden sich an einem Ort, was die Verarbeitung von Parameterdefinitionen effizienter macht.

Dieses Element wird verwendet, um die Parameter zu definieren, die an die Abfrage innerhalb der Vorlage übergeben werden. Jedes -Element definiert einen Parameter. Im -Tag können mehrere -Elemente definiert werden.

Dieses Element wird verwendet, um eine SQL-Abfrage anzugeben. In einer Vorlage können mehrere -Elemente angegeben werden.

Dieses Element wird verwendet, um eine XPath-Abfrage anzugeben. Da XPath-Abfragen auf einem mit Anmerkungen versehenen XML Data Reduction (XDR)-Schema ausgeführt werden, muss der Name der Schemadatei mithilfe des Attributs „mapping-schema“ angegeben werden.

sql:xsl

Dieses Attribut wird verwendet, um das XSL-Stylesheet (Extensible Stylesheet Language) anzugeben, das auf das resultierende XML-Dokument angewendet wird. Beim Angeben einer Zuordnungsschemadatei können Sie einen relativen oder absoluten Pfad angeben. Der angegebene relative Pfad ist relativ zu dem Verzeichnis, das dem virtuellen Namen des Vorlagentyps zugeordnet ist. Wenn das mit dem virtuellen Namen des Vorlagentyps verknüpfte Verzeichnis beispielsweise C:Template ist, wird der für sql:xsl angegebene relative Pfad Xyz/MyXSL.xml zu C:TemplateXyzMyXSL.xml zugeordnet.

mapping-schema

Dieses Attribut wird verwendet, um das annotierte XDR-Schema zu identifizieren. Geben Sie dieses Attribut nur an, wenn Sie eine XPath-Abfrage in der Vorlage durchführen. XPath-Abfragen werden auf annotierten XDR-Schemas ausgeführt. Beim Angeben einer Zuordnungsschemadatei können Sie einen relativen oder absoluten Pfad angeben. Der angegebene relative Pfad ist relativ zu dem Verzeichnis, das dem virtuellen Namen des Vorlagentyps zugeordnet ist. Wenn das mit dem virtuellen Namen des Vorlagentyps verknüpfte Verzeichnis beispielsweise C:Template ist, wird der relative Pfad (schema/MSchema.xml, der für „mapping-schema“ angegeben ist) auf C:TemplateSchemaMSchema.xml abgebildet.

Beschreibung Jede stellt eine separate Transaktion dar. Wenn Sie also mehrere -Tags in einer Vorlage haben, werden die anderen fortgesetzt, wenn eines fehlschlägt.

Wenn der Inhaltstyp festgelegt ist, gibt Sqlisapi.dll Header-Informationen an den Browser zurück. Wenn der Inhaltstyp nicht festgelegt ist, verwendet urlmon das erste Zeichen in der Vorlagendatei, um den Inhaltstyp zu bestimmen. Wenn das erste Zeichen in der Vorlage ein <-Zeichen oder die Unicode-Bytereihenfolgemarke (0xFFFE) ist, wird text/xml als Inhaltstyp an den Browser zurückgegeben und der Browser zeigt das Ergebnis an. Andernfalls sendet Sqlisapi.dll keine Inhaltstyp-Headerinformationen, die den Browser anweisen, wie die Ergebnisse angezeigt werden sollen. Daher sind die Ergebnisse nicht im Browser sichtbar.

Bevor Sie eine Vorlage in einer URL-Vorlage angeben können, müssen Sie mit dem IIS Virtual Directory Management-Dienstprogramm für SQL Server eine virtuelle Namenstypvorlage erstellen. Weitere Informationen finden Sie unter Verwenden des IIS Virtual Directory Management Utility für SQL Server.

Vorlagen speichern
Vorlagen werden in dem Verzeichnis gespeichert, das einem virtuellen Namen vom Typ Vorlage oder einem seiner Unterverzeichnisse zugeordnet ist:

Wenn die Vorlage in einem Verzeichnis gespeichert ist, das einem virtuellen Namen zugeordnet ist vom Typ Vorlage hat die URL-Abfrage die Form:

http://IISServer/nwind/TemplateVirtualName/TemplateFile.xml

Wenn die Vorlage in einem Unterverzeichnis gespeichert ist, das dem virtuellen Namen des Vorlagentyps (xyz) zugeordnet ist, hat die URL-Abfrage die Form :

http://IISServer/nwind/TemplateVirtualName/xyz/TemplateFile.xml

Namespaces werden für direkt in der URL angegebene XPath-Abfragen nicht unterstützt. Wenn Sie Namespaces in XPath-Abfragen verwenden möchten, sollten Sie die Vorlage

verwenden. Das Obige ist der Inhalt der Verwendung von XML-Vorlagen (MSSQL-Handbuch). Weitere verwandte Inhalte finden Sie auf der chinesischen PHP-Website (www.php.cn )!