SqlDataReader.GetStream(Int32) Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Extrait le fichier binaire, l'image, le varbinary, le type défini par l'utilisateur et les types de données Variant sous forme d'un Stream.

public:
 override System::IO::Stream ^ GetStream(int i);

public override System.IO.Stream GetStream (int i);

override this.GetStream : int -> System.IO.Stream

Public Overrides Function GetStream (i As Integer) As Stream

Paramètres

i

Int32

Numéro de colonne de base zéro.

Retours

Stream

Objet de flux.

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 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 l'un des types suivants :

• binary

• image

• varbinary

• udt

Remarques

ReadTimeout par défaut sur la valeur de CommandTimeout; mais vous pouvez le modifier ReadTimeout via GetStream.

Les valeurs Null sont retournées sous la forme d’un vide (zéro octet) Stream.

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

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

Les membres suivants Stream ne sont pas disponibles pour les objets retournés par GetStream:

• BeginWrite

• EndWrite

• Longueur

• Position

• Seek

• SetLength

• Write

• WriteByte

• WriteTimeout

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