Объект SqlXmlCommand (управляемые классы SQLXML)

Это конструктор для объекта SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Где cnString находится строка подключения ADO или OLEDB, которая определяет сервер, базу данных и сведения о входе, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI"например.

В строке Provider подключения должен быть SQLOLEDB и Data Provider не должен включаться в строку поставщика).

Рабочий пример см. в разделе "Выполнение запросов SQL" (управляемые классы SQLXML).

Методы

Объект TheSqlXmlCommand поддерживает несколько методов, включая следующие методы для выполнения команды:

void ExecuteNonQuery()
Выполняет команду, но не возвращает ничего. Этот метод полезен, если вы хотите выполнить команду nonquery (т. е. команду, которая не возвращает ничего). Например, выполняется диаграмма обновления или DiffGram, которая обновляет записи, но возвращает ничего.

Stream ExecuteStream()
Возвращает новый объект Stream. Этот метод полезен, если вы хотите, чтобы результаты запроса возвращались вам в новом потоке. Рабочий пример см. в разделе "Выполнение запросов SQL" (управляемые классы SQLXML).

public void ExecuteToStream(Stream outputStream)
Записывает результаты запроса в существующий поток. Этот метод полезен при наличии потока, в который нужно добавить результаты (например, для записи результатов запроса в System.Web.HttpResponse.OutputStream). Рабочий пример см. в разделе "Выполнение запросов SQL" (управляемые классы SQLXML).

XmlReader ExecuteXmlReader()
Возвращает объект XmlReader. Этот метод можно использовать для управления данными в объекте XmlReader напрямую или подключаемой к цепочке архитектуры System.Xml. Дополнительные сведения см. в документации по Microsoft .NET Framework. Рабочий пример см. в разделе "Выполнение SQL-запросов с помощью метода ExecuteXMLReader".

Объект TheSqlXmlCommand также поддерживает следующие дополнительные методы:

SqlXmlParameter CreateParameter()
Создает объект SqlXmlParameter. Значения для параметров Name и Value этого объекта можно задать. Этот метод полезен, если вы хотите передать параметры команде. Рабочий пример см. в разделе "Выполнение запросов SQL" (управляемые классы SQLXML).

void ClearParameters()
Очищает параметры, созданные для заданного объекта команды. Этот метод полезен, если требуется выполнить несколько запросов в одном объекте команды.

Свойства

Объект SqlXmlCommand также поддерживает следующие свойства:

ClientSideXml
Если задано значение True, указывает, что преобразование набора строк в XML-файл выполняется на клиенте, а не на сервере. Это свойство полезно при перемещении нагрузки производительности на средний уровень. Это свойство также позволяет упаковать существующие хранимые процедуры с помощью FOR XML для получения выходных данных XML.

SchemaPath
Имя схемы сопоставления вместе с путем к каталогу (например, C:\x\y\MySchema.xml). Это свойство полезно для указания схемы сопоставления для запросов XPath. Указанный путь может быть абсолютным или относительным. Если путь относительн, базовый путь, указанный в базовом пути, используется для разрешения относительного пути. Если базовый путь не указан, относительный путь относительно текущего каталога. Рабочий пример см. в разделе "Доступ к функциям SQLXML" в среде .NET.

XslPath
Имя XSL-файла вместе с путем к каталогу. Указанный путь может быть абсолютным или относительным. Если путь относительн, базовый путь, указанный в базовом пути, используется для разрешения относительного пути. Если базовый путь не указан, относительный путь относительно текущего каталога. Рабочий пример см. в разделе "Применение преобразования XSL " (управляемые классы SQLXML)".

Базовый путь
Базовый путь (путь к каталогу). Это свойство полезно для разрешения относительного пути, указанного для XSL-файла (с помощью свойства XslPath), файла схемы сопоставления (с помощью свойства SchemaPath) или внешней ссылки на схему в XML-шаблоне (указанном с помощью атрибута mapping-schema ).

OutputEncoding
Указывает кодировку потока, возвращаемого при выполнении команды. Это свойство полезно для запроса определенной кодировки для возвращаемого потока. Некоторые часто используемые кодировки: UTF-8, ANSI и Юникод. UTF-8 — это кодировка по умолчанию.

Пространства имен
Позволяет выполнять запросы XPath, использующие пространства имен. Дополнительные сведения о запросах XPath с пространствами имен см. в разделе Выполнение запросов XPath с помощью пространств имен (управляемых классов SQLXML). Рабочий пример см. в разделе "Выполнение запросов XPath" (управляемые классы SQLXML).

RootTag
Предоставляет отдельный корневой элемент для XML, создаваемый выполнением команды. Для допустимого XML-документа требуется один тег корневого уровня. Если команда, выполненная, создает фрагмент XML (без одного элемента верхнего уровня), можно указать корневой элемент для возвращаемого XML. Рабочий пример см. в разделе "Применение преобразования XSL " (управляемые классы SQLXML)".

CommandText
Текст команды. Это свойство используется для указания текста команды, которую требуется выполнить. Рабочий пример см. в разделе "Выполнение запросов SQL" (управляемые классы SQLXML).

CommandStream
Поток команд. Это свойство полезно, если вы хотите выполнить команду из файла (например, XML-шаблон). При использовании CommandStream поддерживаются только значения CommandStream, Template, UpdateGram и DiffGram . Рабочий пример см. в разделе "Выполнение файлов шаблонов с помощью свойства CommandStream".

Тип команды
Определяет тип команды. Это свойство используется для указания типа команды, которую требуется выполнить. Значения в следующей таблице определяют тип команды. Рабочий пример см. в разделе "Доступ к функциям SQLXML" в среде .NET.

Ценность	Описание
SqlXmlCommandType.Sql	Выполняет команду SQL (например, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Выполняет команду XPath (например, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Выполняет XML-шаблон.
SqlXmlCommandType.TemplateFile	Выполняет файл шаблона по указанному пути.
SqlXmlCommandType.UpdateGram	Выполняет диаграмму обновления.
SqlXmlCommandType.Diffgram	Выполняет DiffGram.

См. также

Объект SqlXmlParameter (управляемые классы SQLXML)
Объект SqlXmlAdapter (управляемые классы SQLXML)