SqlDataReader.GetXmlReader(Int32) Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Récupère les données de type XML sous forme d'un 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

Paramètres

i

Int32

Valeur de la colonne spécifiée.

Retours

XmlReader

Objet retourné.

Exceptions

InvalidOperationException

La connexion est perdue ou est fermée pendant la récupération des données.

Fermeture de SqlDataReader au cours de la récupération des données.

Il n'existe aucune donnée prête à être lue (par exemple, le premier Read() n'a pas été appelé ou retourné comme false).

Tentative de lecture en cours d'une colonne précédemment lue en mode séquentiel.

Il y avait une opération asynchrone en cours. Cela s'applique à toutes les méthodes Get* exécutées en mode séquentiel, car elles peuvent être appelées pendant la lecture d'un flux de données.

IndexOutOfRangeException

Tentative de lecture d'une colonne qui n'existe pas.

InvalidCastException

Le type retourné n'était pas XML.

Remarques

L’objet XmlReader retourné par GetXmlReader ne prend pas en charge les opérations asynchrones. Si vous avez besoin d’opérations asynchrones sur un XmlReader, castez la colonne XML en NVARCHAR(MAX) sur le serveur et utilisez GetTextReader avec Create.

SqlExceptionles exceptions levées à partir de XmlReader sont levées en tant qu’exceptions XmlException ; vérifiez l’exception interne pour .SqlException

GetChars déclenche une exception lorsqu’elle InvalidOperationException est utilisée sur un objet retourné par GetXmlReader quand SequentialAccess est en vigueur.

Pour plus d’informations, consultez Prise en charge de SqlClient Streaming.