SqlDataReader.GetXmlReader(Int32) Método

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.8.6

Recupera dados do tipo XML como um XmlReader.

public:
 virtual System::Xml::XmlReader ^ GetXmlReader(int i);

public virtual System.Xml.XmlReader GetXmlReader (int i);

abstract member GetXmlReader : int -> System.Xml.XmlReader
override this.GetXmlReader : int -> System.Xml.XmlReader

Public Overridable Function GetXmlReader (i As Integer) As XmlReader

Parâmetros

i

Int32

O valor da coluna especificada.

Retornos

XmlReader

O objeto retornado.

Exceções

InvalidOperationException

A conexão cai ou é fechada durante a recuperação de dados.

O SqlDataReader é fechado durante a recuperação de dados.

Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornou false).

Tentando ler uma coluna lida anteriormente no modo sequencial.

Havia uma operação assíncrona em andamento. Isso se aplica a todos os métodos Get* executados no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.

IndexOutOfRangeException

Tentativa de ler uma coluna não existente.

InvalidCastException

O tipo retornado não era xml.

Comentários

O XmlReader objeto retornado por GetXmlReader não dá suporte a operações assíncronas. Se você precisar de operações assíncronas em um XmlReader, converta a coluna XML em um NVARCHAR(MAX) no servidor e use GetTextReader com Create.

SqlExceptionexceções geradas de XmlReader são geradas como XmlException exceções; marcar a exceção interna para o SqlException.

GetChars gerará uma exceção InvalidOperationException quando usado em um objeto retornado por GetXmlReader quando SequentialAccess estiver em vigor.

Para obter mais informações, consulte Suporte de streaming do SqlClient.