SqlDataReader.GetXmlReader(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.XmlReaderPublic Overridable Function GetXmlReader (i As Integer) As XmlReaderParâmetros
- i
- Int32
O valor da coluna especificada.
Retornos
O objeto retornado.
Exceções
A conexão cai ou é fechada durante a recuperação de dados.
A SqlDataReader origem é fechada durante a recuperação de dados.
Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornado false).
Tentando ler uma coluna de leitura anterior no modo sequencial.
Havia uma operação assíncrona em andamento. Isso se aplica a todos os métodos Get* durante a execução no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.
Tentando ler uma coluna que não existe.
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 as exceções geradas XmlReader são geradas como XmlException exceções; verifique a exceção interna do SqlException.
GetChars gerará uma exceção InvalidOperationException quando usada em um objeto retornado por GetXmlReader quando SequentialAccess estiver em vigor.
Para obter mais informações, consulte o Suporte de Streaming do SqlClient.