SqlFileStream クラス

リファレンス

定義

名前空間:: System.Data.SqlTypes

アセンブリ:: System.Data.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

FILESTREAM 列属性と共に格納されている SQL Server データをバイトシーケンスとして公開します。

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

継承: Object

MarshalByRefObject

Stream
SqlFileStream

注釈

SqlFileStream クラスは、SQL Server 2008 データベースの FILESTREAM 属性と共に格納された varbinary(max) データを操作するために使用されます。 SqlFileStream を使用して FILESTREAM データを操作するには、.NET Framework 3.5 SP1 (またはそれ以降) をインストールする必要があります。

varbinary(max) 列に FILESTREAM 属性を指定すると、SQL Server はデータベースファイルではなくローカル NTFS ファイルシステムにデータを格納します。 Transact-SQL ステートメントはサーバー内のデータ操作機能を提供し、Win32 ファイルシステムインターフェイスはデータへのストリーミングアクセスを提供します。

手記

FILESTREAM 列に格納されている個々のファイルを NTFS ファイルシステムから直接開くことはできません。 FILESTREAM データのストリーミングは、SQL Server トランザクションのコンテキストでのみ機能します。

SqlFileStream クラスは、ファイルやメモリブロックなどの任意のデータソースからのバイトシーケンスの抽象化を表す Stream クラスから派生します。 FILESTREAM から読み取ることができるのは、ストリームからバイト配列などのデータ構造にデータを転送することです。 FILESTREAM に書き込むには、データ構造からストリームにデータを転送します。ストリーム内でシークすることもできます。これにより、ストリーム内の現在の位置にあるデータのクエリと変更を行うことができます。

概念に関するドキュメントとコード例については、FILESTREAM データ参照してください。

SQL Server での FILESTREAM データの設定と構成に関するドキュメントについては、「SQL Server 2008 オンラインブックの FILESTREAM ストレージの設計と実装」を参照してください。

コンストラクター

SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)	SqlFileStream クラスの新しいインスタンスを初期化します。
SqlFileStream(String, Byte[], FileAccess)	SqlFileStream クラスの新しいインスタンスを初期化します。

プロパティ

CanRead	現在のストリームが読み取りをサポートしているかどうかを示す値を取得します。
CanSeek	現在のストリームがシークをサポートしているかどうかを示す値を取得します。
CanTimeout	現在のストリームがタイムアウトできるかどうかを示す値を取得します。
CanWrite	現在のストリームが書き込みをサポートしているかどうかを示す値を取得します。
Length	現在のストリームの長さをバイト単位で示す値を取得します。
Name	コンストラクターに渡される SqlFileStream の論理パスを取得します。
Position	現在のストリーム内の位置を取得または設定します。
ReadTimeout	ストリームがタイムアウトするまでの読み取りを試行する時間を決定する値をミリ秒単位で取得または設定します。
TransactionContext	この SqlFileStream オブジェクトのトランザクションコンテキストを取得または設定します。
WriteTimeout	ストリームがタイムアウトするまでの書き込みを試行する時間を決定する値をミリ秒単位で取得または設定します。

メソッド

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	非同期読み取り操作を開始します。
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	非同期書き込み操作を開始します。
Close()	現在のストリームを閉じ、現在のストリームに関連付けられているリソース (ソケットやファイルハンドルなど) を解放します。このメソッドを呼び出す代わりに、ストリームが適切に破棄されていることを確認します。 (継承元 Stream)
CopyTo(Stream, Int32)	現在のストリームからバイトを読み取り、指定されたバッファーサイズを使用して別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyTo(Stream)	現在のストリームからバイトを読み取り、別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, CancellationToken)	現在のストリームからバイトを非同期に読み取り、指定されたキャンセルトークンを使用して別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, Int32, CancellationToken)	指定したバッファーサイズとキャンセルトークンを使用して、現在のストリームからバイトを非同期に読み取り、別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, Int32)	現在のストリームからバイトを非同期に読み取り、指定されたバッファーサイズを使用して別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream)	現在のストリームからバイトを非同期に読み取り、別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。 (継承元 Stream)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
CreateWaitHandle()	古い. 古い. 古い. WaitHandle オブジェクトを割り当てます。 (継承元 Stream)
Dispose()	Streamで使用されているすべてのリソースを解放します。 (継承元 Stream)
Dispose(Boolean)	Stream によって使用されるアンマネージリソースを解放し、必要に応じてマネージドリソースを解放します。 (継承元 Stream)
DisposeAsync()	Streamによって使用されるアンマネージリソースを非同期的に解放します。 (継承元 Stream)
EndRead(IAsyncResult)	保留中の非同期読み取りが完了するまで待機します。
EndWrite(IAsyncResult)	非同期書き込み操作を終了します。
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Finalize()	ガベージコレクターが SqlFileStreamを回収するときに、リソースが解放され、その他のクリーンアップ操作が実行されるようにします。
Flush()	は、このストリームのすべてのバッファーをクリアし、バッファー内のデータを基になるデバイスに書き込みます。
FlushAsync()	このストリームのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (継承元 Stream)
FlushAsync(CancellationToken)	このストリームのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込み、取り消し要求を監視します。 (継承元 Stream)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ObjectInvariant()	古い. Contractのサポートを提供します。 (継承元 Stream)
Read(Byte[], Int32, Int32)	現在のストリームからバイトシーケンスを読み取り、読み取ったバイト数だけストリーム内の位置を進めます。
Read(Span<Byte>)	派生クラスでオーバーライドされると、現在のストリームからバイトシーケンスを読み取り、読み取られたバイト数だけストリーム内の位置を進めます。 (継承元 Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	現在のストリームからバイトシーケンスを非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進め、取り消し要求を監視します。 (継承元 Stream)
ReadAsync(Byte[], Int32, Int32)	現在のストリームからバイトシーケンスを非同期に読み取り、ストリーム内の位置を読み取ったバイト数だけ進めます。 (継承元 Stream)
ReadAsync(Memory<Byte>, CancellationToken)	現在のストリームからバイトシーケンスを非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進め、取り消し要求を監視します。 (継承元 Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	現在のストリームから少なくともバイト数を読み取り、読み取ったバイト数だけストリーム内の位置を進めます。 (継承元 Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	現在のストリームから少なくとも最小バイト数を非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進め、キャンセル要求を監視します。 (継承元 Stream)
ReadByte()	ストリームからバイトを読み取り、ストリーム内の位置を 1 バイト進めるか、ストリームの末尾にある場合は -1 を返します。
ReadExactly(Byte[], Int32, Int32)	現在のストリーム `count` バイト数を読み取り、ストリーム内の位置を進めます。 (継承元 Stream)
ReadExactly(Span<Byte>)	現在のストリームからバイトを読み取り、`buffer` がいっぱいになるまでストリーム内の位置を進めます。 (継承元 Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	現在のストリーム `count` バイト数を非同期に読み取り、ストリーム内の位置を進め、キャンセル要求を監視します。 (継承元 Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	現在のストリームからバイトを非同期に読み取り、`buffer` がいっぱいになるまでストリーム内の位置を進め、取り消し要求を監視します。 (継承元 Stream)
Seek(Int64, SeekOrigin)	現在のストリーム内の位置を設定します。
SetLength(Int64)	現在のストリームの長さを設定します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Write(Byte[], Int32, Int32)	現在のストリームにバイトシーケンスを書き込み、書き込まれたバイト数だけこのストリーム内の現在位置を進めます。
Write(ReadOnlySpan<Byte>)	派生クラスでオーバーライドされると、現在のストリームにバイトシーケンスを書き込み、書き込まれたバイト数だけこのストリーム内の現在の位置を進めます。 (継承元 Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込まれたバイト数だけこのストリーム内の現在位置を進め、キャンセル要求を監視します。 (継承元 Stream)
WriteAsync(Byte[], Int32, Int32)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込まれたバイト数だけこのストリーム内の現在位置を進めます。 (継承元 Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込まれたバイト数だけこのストリーム内の現在位置を進め、キャンセル要求を監視します。 (継承元 Stream)
WriteByte(Byte)	ストリーム内の現在位置にバイトを書き込み、ストリーム内の位置を 1 バイト進めます。

拡張メソッド

CopyToAsync(Stream, PipeWriter, CancellationToken)

キャンセルトークンを使用して、Stream からバイトを非同期に読み取り、指定した PipeWriterに書き込みます。

適用対象

こちらもご覧ください

FILESTREAM データの
SQL Server データ型マッピング (ADO.NET)
SQL Server バイナリおよび Large-Value データ (ADO.NET)

次の方法で共有