SqlFileStream Kelas

Definisi

Ruang nama:

System.Data.SqlTypes

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Mengekspos data SQL Server yang disimpan dengan atribut kolom FILESTREAM sebagai urutan byte.

public ref class SqlFileStream sealed : System::IO::Stream

public sealed class SqlFileStream : System.IO.Stream

type SqlFileStream = class
    inherit Stream

Public NotInheritable Class SqlFileStream
Inherits Stream

Warisan

Object

Stream

SqlFileStream

Keterangan

Kelas SqlFileStream ini digunakan untuk bekerja dengan varbinary(max) data yang disimpan dengan atribut FILESTREAM dalam database SQL Server 2008. Anda harus menginstal .NET Framework 3.5 SP1 (atau yang lebih baru) untuk digunakan SqlFileStream untuk bekerja dengan data FILESTREAM.

Menentukan atribut FILESTREAM pada varbinary(max) kolom menyebabkan SQL Server menyimpan data dalam sistem file NTFS lokal alih-alih dalam file database. Pernyataan Transact-SQL menyediakan kemampuan manipulasi data dalam server, dan antarmuka sistem file Win32 menyediakan akses streaming ke data.

Catatan

File individual yang disimpan dalam kolom FILESTREAM tidak dapat dibuka langsung dari sistem file NTFS. Streaming data FILESTREAM hanya berfungsi dalam konteks transaksi SQL Server.

Kelas SqlFileStream ini berasal dari Stream kelas , yang mewakili abstraksi urutan byte dari beberapa sumber data arbitrer seperti file atau blok memori. Anda dapat membaca dari FILESTREAM dengan mentransfer data dari aliran ke dalam struktur data seperti array byte. Anda dapat menulis ke FILESTREAM dengan mentransfer data dari struktur data ke dalam aliran. Anda juga dapat mencari di dalam aliran, yang memungkinkan Anda untuk mengkueri dan memodifikasi data pada posisi saat ini dalam aliran.

Untuk dokumentasi konseptual dan contoh kode, lihat Data FILESTREAM.

Untuk dokumentasi tentang menyiapkan dan mengonfigurasi data FILESTREAM di SQL Server, lihat Merancang dan Menerapkan Penyimpanan FILESTREAM di SQL Server 2008 Books Online.

Konstruktor

SqlFileStream(String, Byte[], FileAccess)	Menginisialisasi instans baru kelas SqlFileStream.
SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)	Menginisialisasi instans baru kelas SqlFileStream.

Properti

CanRead	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung pembacaan.
CanSeek	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung pencarian.
CanTimeout	Mendapatkan nilai yang menunjukkan apakah aliran saat ini dapat kehabisan waktu.
CanWrite	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung penulisan.
Length	Mendapatkan nilai yang menunjukkan panjang aliran saat ini dalam byte.
Name	Mendapatkan jalur logis yang SqlFileStream diteruskan ke konstruktor.
Position	Mendapatkan atau mengatur posisi dalam aliran saat ini.
ReadTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba membaca sebelum waktu habis.
TransactionContext	Mendapatkan atau mengatur konteks transaksi untuk objek ini SqlFileStream .
WriteTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba menulis sebelum waktu habis.

Metode

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi baca asinkron.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi tulis asinkron.
Close()	Menutup aliran saat ini dan merilis sumber daya apa pun (seperti soket dan handel file) yang terkait dengan aliran saat ini. Alih-alih memanggil metode ini, pastikan aliran dibuang dengan benar. (Diperoleh dari Stream)
CopyTo(Stream)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyTo(Stream, Int32)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan token pembatalan tertentu. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer dan token pembatalan tertentu. Kedua posisi aliran dilanjutkan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CreateWaitHandle()	Mengalokasikan WaitHandle objek. (Diperoleh dari Stream)
Dispose()	Merilis semua sumber daya yang Streamdigunakan oleh . (Diperoleh dari Stream)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Stream dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Stream)
DisposeAsync()	Secara asinkron merilis sumber daya yang tidak dikelola yang digunakan oleh Stream. (Diperoleh dari Stream)
EndRead(IAsyncResult)	Menunggu pembacaan asinkron yang tertunda selesai.
EndWrite(IAsyncResult)	Mengakhiri operasi penulisan asinkron.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Memastikan bahwa sumber daya dibebaskan dan operasi pembersihan lainnya dilakukan ketika pengumpul sampah mengklaim SqlFileStreamkembali .
Flush()	menghapus semua buffer untuk aliran ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar.
FlushAsync()	Secara asinkron menghapus semua buffer untuk aliran ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar. (Diperoleh dari Stream)
FlushAsync(CancellationToken)	Secara asinkron menghapus semua buffer untuk aliran ini, menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ObjectInvariant()	Menyediakan dukungan untuk Contract. (Diperoleh dari Stream)
Read(Byte[], Int32, Int32)	Membaca urutan byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca.
Read(Span<Byte>)	Ketika ditimpa di kelas turunan, membaca urutan byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAsync(Byte[], Int32, Int32)	Secara asinkron membaca urutan byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca urutan byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca urutan byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Membaca setidaknya jumlah minimum byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Secara asinkron membaca setidaknya jumlah minimum byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadByte()	Membaca byte dari aliran dan memajukan posisi dalam aliran dengan satu byte, atau mengembalikan -1 jika di akhir aliran.
ReadExactly(Byte[], Int32, Int32)	count Membaca jumlah byte dari aliran saat ini dan memajukan posisi dalam aliran. (Diperoleh dari Stream)
ReadExactly(Span<Byte>)	Membaca byte dari aliran saat ini dan memajukan posisi dalam aliran hingga buffer terisi. (Diperoleh dari Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca count jumlah byte dari aliran saat ini, memajukan posisi dalam aliran, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini, memajukan posisi dalam aliran hingga buffer terisi, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
Seek(Int64, SeekOrigin)	Mengatur posisi dalam aliran saat ini.
SetLength(Int64)	Mengatur panjang aliran saat ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Write(Byte[], Int32, Int32)	Menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis.
Write(ReadOnlySpan<Byte>)	Ketika ditimpa di kelas turunan, menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis. (Diperoleh dari Stream)
WriteAsync(Byte[], Int32, Int32)	Secara asinkron menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis. (Diperoleh dari Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
WriteByte(Byte)	Menulis byte ke posisi saat ini di aliran dan memajukan posisi dalam aliran dengan satu byte.

Metode Ekstensi

CopyToAsync(Stream, PipeWriter, CancellationToken)

Secara asinkron membaca byte dari Stream dan menulisnya ke yang ditentukan PipeWriter, menggunakan token pembatalan.

Lihat juga

• Data FILESTREAM
• Pemetaan Tipe Data SQL Server (ADO.NET)
• SQL Server Data Biner dan Large-Value (ADO.NET)