SqlDataReader.GetStream(Int32) Metodo

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacchetto:

System.Data.SqlClient v4.8.6

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.

Restituisce

Stream

Oggetto di flusso.

Eccezioni

InvalidOperationException

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

SqlDataReader viene chiuso durante il richiamo dei dati.

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

Ha tentato di leggere una colonna letta in precedenza in modalità sequenziale.

Operazione asincrona in corso. Si applica a tutti i metodi Get* durante l'esecuzione in modalità sequenziale, in quanto 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 di seguito:

• BINARY

• image

• varbinary

• udt

Commenti

ReadTimeout il valore predefinito è CommandTimeout. È tuttavia possibile modificare ReadTimeout tramite GetStream.

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

GetBytes genererà un'eccezione InvalidOperationException quando viene utilizzata in 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

• Length

• Posizione

• Seek

• SetLength

• Scrittura

• WriteByte

• WriteTimeout

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

Per altre informazioni, vedere Supporto per lo streaming sqlClient.