SqlDataReader.GetStream(Int32) Metode

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.dll

Mengambil jenis data biner, gambar, varbinary, UDT, dan varian sebagai 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

Parameter

i
Int32

Ordinal kolom berbasis nol.

Mengembalikan

Stream

Objek streaming.

Pengecualian

InvalidOperationException

Koneksi terputus atau ditutup selama pengambilan data.

SqlDataReader ditutup selama pengambilan data.

Tidak ada data yang siap dibaca (misalnya, yang pertama Read() belum dipanggil, atau dikembalikan salah).

Mencoba membaca kolom yang dibaca sebelumnya dalam mode berurutan.

Ada operasi asinkron yang sedang berlangsung. Ini berlaku untuk semua metode Get* saat berjalan dalam mode berurutan, karena dapat dipanggil saat membaca aliran.

IndexOutOfRangeException

Mencoba membaca kolom yang tidak ada.

InvalidCastException

Jenis yang dikembalikan bukan salah satu tipe di bawah ini:

  • biner
  • citra
  • varbinary
  • udt

Keterangan

ReadTimeout default ke nilai CommandTimeout; tetapi Anda dapat memodifikasi ReadTimeout melalui GetStream.

Nilai null akan dikembalikan sebagai kosong (nol byte) Stream.

GetBytes akan menaikkan InvalidOperationException pengecualian saat digunakan pada objek yang dikembalikan oleh GetStream kapan SequentialAccess berlaku.

SqlException pengecualian yang dimunculkan dari Stream dilemparkan sebagai IOException pengecualian; periksa pengecualian dalam untuk SqlException.

Anggota berikut Stream ini tidak tersedia untuk objek yang dikembalikan oleh GetStream:

  • Mulai Tulis

  • AkhiriTulisan

  • Length

  • Position

  • Mencari

  • AturPanjang

  • Write

  • WriteByte

  • WriteTimeout

Ketika properti ContextConnection=truekoneksi , GetStream hanya mendukung pengambilan data sinkron untuk akses berurutan (SequentialAccess) dan non-berurutan (Default).

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.

Berlaku untuk