Поделиться через


Элемент заголовка sqloptions:sqlSession

Будучи указанным в качестве заголовка SOAP, параметр sqloptions:sqlSession дает возможность клиенту управлять сеансом для запроса.

Он состоит из одного элемента с именем sqloptions:sqlSession. Этот элемент имеет пять необязательных атрибутов: initiate, terminate, sessionId, timeout и transactionDescriptor. Дополнительные сведения о применении и работе соответствующих атрибутов см. в разделе Работа с сеансами 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>

См. также

Справочник

Дополнительные SOAP-заголовки

Справка и поддержка

Получение помощи по SQL Server 2005