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


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

В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется.

Будучи указанным в качестве заголовка 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>

См. также

Справочник