SqlCommand.ExecuteXmlReader Метод

public:
 System::Xml::XmlReader ^ ExecuteXmlReader();

public System.Xml.XmlReader ExecuteXmlReader ();

member this.ExecuteXmlReader : unit -> System.Xml.XmlReader

Public Function ExecuteXmlReader () As XmlReader

Возвращаемое значение

Объект XmlReader.

Исключения

Примеры

В следующем примере создается SqlCommand и выполняется с помощью ExecuteXmlReader. В этом примере передается строка, которая является инструкцией SELECT Transact-SQL FOR XML, и строка, используемая для подключения к источнику данных.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

private static void CreateXMLReader(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        connection.Open();
        SqlCommand command = new SqlCommand(queryString, connection);
        System.Xml.XmlReader reader = command.ExecuteXmlReader();
    }
}

Комментарии

XmlReader, возвращаемый этим методом, не поддерживает асинхронные операции. Свойство CommandText обычно задает инструкцию Transact-SQL с допустимым предложением FOR XML. Однако может также указать оператор, CommandText который возвращает ntext или nvarchar данные, содержащие допустимый XML, или содержимое столбца, определенного с типом xml данных .

Типичный ExecuteXmlReader запрос может быть отформатирован в следующем примере Microsoft Visual C#:

SqlCommand command = new SqlCommand("SELECT * FROM dbo.Customers FOR XML AUTO, XMLDATA", SqlConn);

Этот метод также можно использовать для получения однострочного результирующий набор с одним столбцом, который содержит XML-данные. В этом случае, если возвращается несколько строк, ExecuteXmlReader метод прикрепляет XmlReader к значению в первой строке и удаляет остальную часть результированного набора.

Функция множественных активных результирующих наборов (MARS) позволяет выполнять несколько действий, использующих одно и то же подключение.

Если вы используете ExecuteReader или BeginExecuteReader для доступа к XML-данным, SQL Server вернет все результаты XML длиной более 2033 символов в нескольких строках по 2033 символа каждый. Чтобы избежать такого поведения, используйте ExecuteXmlReader или BeginExecuteXmlReader для чтения запросов FOR XML.

Применяется к