sqloptions:sqlSession (Header Element)
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.
Durch die Option sqloptions:sqlSession erhält der Client die Fähigkeit, die Sitzung für die Anforderung zu steuern, wenn sie einen SOAP-Header enthält und einen als SOAP-Header angezeigt wird.
Der Header besteht aus einem Element namens sqloptions:sqlSession. Das Element verfügt über fünf optionale Attribute: initiate, terminate, sessionId, timeout und transactionDescriptor. Weitere Informationen zum Verwenden einzelner Attribute und zu deren Verhalten finden Sie unter Arbeiten mit SOAP-Sitzungen.
In einer Anforderung oder Antwort kann jeweils nur eine Instanz der Option sqloptions:sqlSession vorkommen. Mehrere Instanzen der Option generieren einen Fehler.
Das folgende Beispiel ist ein Schemafragment für die Option sqloptions:sqlSession:
<xs:element name="sqlSession form="qualified">
<xs:annotation>
<xs:documentation>
SQL Server SOAP Session
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute
name="initiate"
default="false"
type="xs:boolean"
form="unqualified">
<xs:annotation>
<xs:documentation>
TRUE to request to start a new session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute
name="terminate"
default="false"
type="xs:boolean"
form="unqualified">
<xs:annotation>
<xs:documentation>
TRUE to request to terminate an existing session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="sessionId" type="xs:base64Binary" form="unqualified">
<xs:annotation>
<xs:documentation>
The ID of a session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="timeout" type="xs:int" form="unqualified">
<xs:annotation>
<xs:documentation>
The timeout in seconds before the session expires.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute
name="transactionDescriptor"
type="xs:base64Binary"
form="unqualified">
<xs:annotation>
<xs:documentation>
The descriptor of a transaction to enlist to.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>