Общие сведения о поставщике SQLXMLOLEDB (SQLXML 4.0)

Поставщик SQLXMLOLEDB — это поставщик OLE DB, предоставляющий функции Microsoft SQLXML через объекты данных ActiveX (ADO). Однако поставщик может выполнять команды только в режиме записи в выходной поток ADO. Поставщик SQLXMLOLEDB не является поставщиком набора строк. При выполнении команды необходимо указать флаг adExecuteStream, который направляет ADO для использования указанного выходного потока.

В следующем примере показан синтаксис команды Execute, в которой указан флаг adExecuteStream:

Dim oTestCommand As New ADODB.Command  
...  
oTestCommand.Properties("Output Stream").Value = oTestStream  
oTestCommand.Execute , , adExecuteStream  
...  

Свойства поставщика SQLXMLOLEDB

Поставщик SQLXMLOLEDB предоставляет следующее свойство подключения для конкретного поставщика.

Подключение имущество	По умолчанию (если таковые есть)	Описание
Поставщик данных		Предоставляет PROGID поставщика OLE DB, с помощью которого SQLXMLOLEDB выполняет команды. Начиная с SQLXML 4.0 и SQL Server 2005, этот поставщик содержится в собственном клиенте SQL Server; Таким образом, это значение свойства ограничено значением "SQLNCLI11". Дополнительные сведения см. в статье Программирование SQL Server Native Client.

Поставщик SQLXMLOLEDB предоставляет следующие свойства команд для конкретного поставщика.

командование имущество	По умолчанию (если таковые есть)	Описание
Базовый путь	""	Указывает базовый путь к файлу. Базовый путь к файлу используется для указания расположения файлов таблицы стилей XML (XSL) или сопоставления файлов схемы. Базовый путь к файлу также используется для разрешения относительных путей XSL или сопоставления файлов схемы, указанных в свойствах XSL или сопоставления схемы. Пример использования этого свойства см. в разделе "Выполнение запросов XPath" (поставщик SQLXMLOLEDB).
ClientSideXML	Неправда	Присвойте этому свойству значение True, если требуется, чтобы процесс преобразования набора строк в XML происходил на клиенте, а не на сервере. Это полезно при перемещении нагрузки производительности на средний уровень. Пример использования этого свойства см. в разделе "Выполнение sql-запросов( поставщик SQLXMLOLEDB) или выполнение шаблонов, содержащих SQL-запросы (поставщик SQLXMLOLEDB)".
Тип контента		Возвращает тип выходного контента. Это свойство READ ONLY. Это свойство предоставляет сведения в браузере о типе контента (например, TEXT/XML, TEXT/HTML, image/jpeg и т. д.). Значение этого свойства становится полем типа контента , которое отправляется в браузер как часть заголовка HTTP, который содержит тип MIME (многоцелевых расширений электронной почты) документа, отправляемого в виде текста.
Схема сопоставления	Отсутствует	Если клиентское приложение выполняет запрос XPath к схеме сопоставления (XDR или XSD), это свойство используется для указания имени схемы сопоставления. Указанный путь может быть относительным (xyz/abc/MySchema.xml) или абсолютным (C:\MyFolder\abc\MySchema.xml). Если указан относительный путь, базовый путь, заданный свойством Base Path, используется для разрешения относительного пути. Если в свойстве Base Path не указан путь, относительный путь относится к текущему каталогу. При указании значения свойства схемы сопоставления можно указать путь к локальному каталогу или URL-адрес (http://...). Если указать URL-адрес, необходимо настроить WinHTTP для доступа к HTTP-серверам и HTTPS через прокси-сервер. Это можно сделать, выполнив программу Proxycfg.exe. Дополнительные сведения см. в разделе "Использование служебной программы конфигурации прокси-сервера WinHTTP" в библиотеке MSDN. Пример использования этого свойства см. в разделе "Выполнение запросов XPath" (поставщик SQLXMLOLEDB).
пространства имен		Это свойство позволяет выполнять запросы XPath, использующие пространства имен. Пример использования этого свойства см. в разделе Выполнение запросов XPath с помощью пространств имен (поставщик SQLXMLOLEDB).
SS Stream Flags		Это свойство используется для указания определенных типов ограничений безопасности. Например, может потребоваться запретить ссылки НА URL-адреса на файлы или абсолютные пути к файлам (например, внешние сайты). Или вы не хотите разрешать запросы в шаблонах. Это свойство можно назначить следующими значениями: 1 = STREAM_FLAGS_DISALLOW_URL 2 = STREAM_FLAGS_DISALLOW_ABSOLUTE_PATH 4 = STREAM_FLAGS_DISALLOW_QUERY 8 = STREAM_FLAGS_ DONTCACHEMAPPINGSCHEMA 16 = STREAM_FLAGS_DONTCACHETEMPLATE 32 = STREAM_FLAGS_DONTCACHEXSL Дополнительные сведения об этих значениях приведены в следующей таблице.
корневой файл XML		Это свойство используется для определения корневого тега для результирующего XML-кода. Например, если вы выполняете SQL-запросы к базе данных и результирующий XML-документ не имеет одного корневого элемента, значение свойства используется для добавления одного корневого элемента в документ. Пример использования этого свойства см. в разделе "Выполнение запросов SQL" (поставщик SQLXMLOLEDB).
xsl		Это свойство используется для указания имени файла XSL, если требуется применить преобразование XSL к XML-документу, возвращаемого запросом. Указанный путь может быть относительным (xyz/abc/MyXSL.xsl) или абсолютным (C:\MyFolder\abc\MyXSL.xsl). Если указан относительный путь, базовый путь, заданный свойством Base Path, используется для разрешения относительного пути. Если в свойстве Base Path не указан путь, относительный путь относится к текущему каталогу. Пример использования этого свойства см. в разделе "Применение преобразования XSL" (поставщик SQLXMLOLEDB).

В следующей таблице содержатся описания значений свойств ss Stream Flags.

Значение свойства	Описание
STREAM_FLAGS_DISALLOW_URL	URL-адреса не принимаются для схем сопоставления или XSL.
STREAM_FLAGS_DISALLOW_ABSOLTE_PATH	Путь, указанный для схемы сопоставления или XSL, должен быть относительно базового пути самого шаблона.
STREAM_FLAGS_DISALLOW_QUERY	Запросы не допускаются в шаблоне.
STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA	Схема сопоставления не кэшируется. Это значение свойства полезно на этапе разработки базы данных, когда схемы базы данных подвергаются изменению.
STREAM_FLAGS_DONTCACHETEMPLATE	Шаблоны не кэшируются.
STREAM_FLAGS_DONTCACHEXSL	XSL не кэшируется.