Partager via


Élément d'en-tête sqloptions:sqlSession

L'option sqloptions:sqlSession permet au client de contrôler la session de la demande si elle comprend un en-tête SOAP et est affichée comme telle.

L'en-tête est constitué d'un élément, nommé sqloptions:sqlSession, qui possède cinq attributs facultatifs. initiate, terminate, sessionId, timeout et transactionDescriptor. Pour plus d'informations sur l'utilisation et le comportement des différents attributs, consultez Utilisation de sessions SOAP.

Seule une instance de l'option sqloptions:sqlSession peut figurer dans une demande ou dans une réponse. Plusieurs instances de cette option entraîneraient une erreur.

Vous trouverez ci-dessous un fragment de schéma pour l'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>

Voir aussi

Référence

En-têtes d'extension SOAP

Aide et Informations

Assistance sur SQL Server 2005