SqlDataReader.GetXmlReader(Int32) Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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.

SqlException exceções geradas de XmlReader são geradas como XmlException exceções; verifique a exceção interna do 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 ao Streaming do SqlClient.