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.
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.
Tentativa de ler uma coluna não existente.
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.
