SqlDataReader.GetStream(Int32) Methode

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Haalt binaire, afbeeldings-, varbinaire, UDT- en variantgegevenstypen op als een 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

Parameters

i
Int32

De op nul gebaseerde kolomordinaal.

Retouren

Stream

Een stroomobject.

Uitzonderingen

InvalidOperationException

De verbinding wordt verbroken of gesloten tijdens het ophalen van gegevens.

De SqlDataReader gegevens worden gesloten tijdens het ophalen van gegevens.

Er zijn geen gegevens die kunnen worden gelezen (de eerste Read() is bijvoorbeeld niet aangeroepen of retourneert onwaar).

Er is geprobeerd een eerder gelezen kolom te lezen in de sequentiële modus.

Er is een asynchrone bewerking uitgevoerd. Dit geldt voor alle Get*-methoden bij het uitvoeren in de sequentiële modus, omdat ze kunnen worden aangeroepen tijdens het lezen van een stream.

IndexOutOfRangeException

Er wordt geprobeerd een kolom te lezen die niet bestaat.

InvalidCastException

Het geretourneerde type is niet een van de onderstaande typen:

  • binary
  • afbeelding
  • varbinary
  • udt

Opmerkingen

ReadTimeout is standaard ingesteld op de waarde van CommandTimeout; maar u kunt dit wijzigen ReadTimeout via GetStream.

Null-waarden worden geretourneerd als een lege waarde (nul bytes). Stream

GetBytes genereert een InvalidOperationException uitzondering wanneer het wordt gebruikt voor een object dat wordt geretourneerd door GetStream wanneer SequentialAccess dit van kracht is.

SqlException uitzonderingen worden Stream gegenereerd als IOException uitzonderingen; controleer de binnenste uitzondering voor de SqlException.

De volgende Stream leden zijn niet beschikbaar voor objecten die worden geretourneerd door GetStream:

  • BeginSchrijven

  • EndWrite

  • Lengte

  • Position

  • Zoeken

  • SetLength

  • Write

  • WriteByte

  • WriteTimeout

Wanneer de verbindingseigenschap GetStreamContextConnection=truealleen synchrone gegevens ophalen ondersteunt voor zowel sequentiële (SequentialAccess) als niet-sequentiële (Default) toegang.

Zie Ondersteuning voor sqlClient-streaming voor meer informatie.

Van toepassing op