共用方式為


sqloptions:sqlSession 標頭元素

未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。

sqloptions:sqlSession 選項可讓用戶端控制包含要求時以及要求顯示為 SOAP 標頭時的工作階段。

標頭是由一個名為 sqloptions:sqlSession 的元素組成。此元素有五個選擇性的屬性:initiateterminatesessionIdtimeouttransactionDescriptor。如需有關個別屬性之使用與行為的詳細資訊,請參閱<使用 SOAP 工作階段>。

只有一個 sqloptions:sqlSession 選項的實例可以出現在要求或是回應中。該選項若有多個執行個體將會產生錯誤。

下列是 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>

請參閱

參考