SqlDataReader.GetXmlReader(Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.
Devoluções
O objeto devolvido.
Exceções
A ligação cai ou é encerrada durante a recuperação dos dados.
O SqlDataReader é fechado durante a recuperação dos dados.
Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou devolveu falso).
A tentar ler uma coluna previamente lida em modo sequencial.
Estava em curso uma operação assíncrona. Isto aplica-se a todos os métodos Get* quando executados em modo sequencial, pois podem ser chamados ao ler um fluxo.
Tentar ler uma coluna que não existe.
O tipo devolvido não era xml.
Observações
O XmlReader objeto devolvido por GetXmlReader não suporta operações assíncronas. Se precisar de operações assíncronas num XmlReader, caste a coluna XML para um NVARCHAR(MAX) no servidor e use GetTextReader com Create.
SqlException exceções levantadas de XmlReader são lançadas como XmlException exceções; verifique a exceção interna para o SqlException.
GetChars criará uma InvalidOperationException exceção quando usada num objeto devolvido por GetXmlReader quando SequentialAccess está em vigor.
Para mais informações, consulte Suporte de Transmissão SQLClient.