Compartilhar via


Elemento do cabeçalho sqloptions:sqlSession

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

A opção sqloptions:sqlSession permite que o cliente controle a sessão para a solicitação quando ela for incluída e exibida como cabeçalho SOAP.

O cabeçalho é composto de um elemento, denominado sqloptions:sqlSession. O elemento tem cinco atributos opcionais: initiate, terminate, sessionId, timeout e transactionDescriptor. Para obter mais informações sobre o uso e comportamento de atributos individuais, consulte Trabalhando com sessões SOAP.

Somente uma instância da opção sqloptions:sqlSession pode aparecer em uma solicitação ou em uma resposta. Várias instâncias da opção gerarão um erro.

Este é um fragmento de esquema da opção 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>

Consulte também

Referência