Elemento intestazione sqloptions:sqlSession
Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.
L'opzione sqloptions:sqlSession consente al client di controllare la sessione per la richiesta quando inclusa ed è visualizzata come intestazione SOAP.
L'intestazione è composta da un elemento denominato sqloptions:sqlSession, a cui possono essere associati cinque attributi facoltativi: initiate, terminate, sessionId, timeout e transactionDescriptor. Per ulteriori informazioni sull'utilizzo e sul funzionamento dei singoli attributi, vedere Utilizzo delle sessioni SOAP.
In una richiesta o in una risposta può essere inclusa una sola istanza dell'opzione sqloptions:sqlSession. In presenza di più istanze dell'opzione verrà generato un errore.
Di seguito è riportato un frammento dello schema dell'opzione 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>