SqlDataReader.GetStream(Int32) Metodo

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.dll

Recupera i tipi di dati binary, image, varbinary, UDT e variant come .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

Parametri

i
Int32

Ordinale di colonna in base zero.

Valori restituiti

Stream

Oggetto flusso.

Eccezioni

InvalidOperationException

La connessione viene eliminata o chiusa durante il recupero dei dati.

L'oggetto SqlDataReader viene chiuso durante il recupero dei dati.

Non sono disponibili dati pronti per la lettura(ad esempio, il primo Read() non è stato chiamato o restituito false).

Si è tentato di leggere una colonna di lettura precedente in modalità sequenziale.

È in corso un'operazione asincrona. Questo vale per tutti i metodi Get* durante l'esecuzione in modalità sequenziale, perché possono essere chiamati durante la lettura di un flusso.

IndexOutOfRangeException

Tentativo di leggere una colonna che non esiste.

InvalidCastException

Il tipo restituito non è uno dei tipi seguenti:

  • binary
  • image
  • varbinary
  • udt

Commenti

ReadTimeout per impostazione predefinita il valore di CommandTimeout, ma è possibile modificare ReadTimeout tramite GetStream.

I valori Null verranno restituiti come vuoti (zero byte). Stream

GetBytes genererà un'eccezione InvalidOperationException quando viene usata su un oggetto restituito da GetStream quando SequentialAccess è attivo.

SqlExceptionLe eccezioni generate da Stream vengono generate come IOException eccezioni. Controllare l'eccezione interna per .SqlException

I membri seguenti Stream non sono disponibili per gli oggetti restituiti da GetStream:

  • BeginWrite

  • EndWrite

  • Durata

  • Posizione

  • Cerca

  • SetLength

  • Scrittura

  • WriteByte

  • WriteTimeout

Quando la proprietà ContextConnection=truedi connessione supporta GetStream solo il recupero sincrono dei dati per l'accesso sequenziale (SequentialAccess) e non sequenziale (Default).

Per altre informazioni, vedere Supporto per lo streaming sqlClient.

Si applica a