SqlFileStream クラス

リファレンス

定義

名前空間:: System.Data.SqlTypes

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

アセンブリ:: 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

Stream
SqlFileStream

継承: Object

MarshalByRefObject

Stream
SqlFileStream

注釈

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

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

注意

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

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

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

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

コンストラクター

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

プロパティ

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

メソッド

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	非同期の読み込み動作を開始します。
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	非同期の読み込み動作を開始します。 (代わりに、ReadAsync(Byte[], Int32, Int32) の使用を検討してください。) (継承元 Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	非同期の書き込み操作を開始します。
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	非同期の書き込み操作を開始します。 (代わりに、WriteAsync(Byte[], Int32, Int32) の使用を検討してください。) (継承元 Stream)
Close()	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。このメソッドを呼び出す代わりに、ストリームが適切に破棄されていることを確認します。 (継承元 Stream)
CopyTo(Stream)	現在のストリームからバイトを読み取り、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyTo(Stream, Int32)	指定されたバッファーサイズを使用して、現在のストリームからバイトを読み取り、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream)	現在のストリームからすべてのバイトを非同期に読み取り、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, CancellationToken)	指定されたバッファーサイズを使用して、現在のストリームからバイトを非同期に読み取り、指定されたキャンセルトークンを使用して、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, Int32)	指定されたバッファーサイズを使用して、現在のストリームからバイトを非同期に読み取り、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CopyToAsync(Stream, Int32, CancellationToken)	指定されたバッファーサイズを使用して、現在のストリームからバイトを非同期に読み取り、指定されたバッファーサイズとキャンセルトークンを使用して、別のストリームに書き込みます。両方のストリーム位置は、コピーされたバイト数だけ進みます。 (継承元 Stream)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
CreateWaitHandle()	互換性のために残されています。互換性のために残されています。互換性のために残されています。 WaitHandle オブジェクトを割り当てます。 (継承元 Stream)
Dispose()	Stream によって使用されているすべてのリソースを解放します。 (継承元 Stream)
Dispose(Boolean)	Stream によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 Stream)
DisposeAsync()	Stream によって使用されているアンマネージリソースを非同期に解放します。 (継承元 Stream)
EndRead(IAsyncResult)	保留中の非同期読み取りが完了するまで待機します。
EndRead(IAsyncResult)	保留中の非同期読み取りが完了するまで待機します。 (代わりに、ReadAsync(Byte[], Int32, Int32) の使用を検討してください。) (継承元 Stream)
EndWrite(IAsyncResult)	非同期書き込み操作を終了します。
EndWrite(IAsyncResult)	非同期書き込み操作を終了します。 (代わりに、WriteAsync(Byte[], Int32, Int32) の使用を検討してください。) (継承元 Stream)
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)	現在のストリームからバイトシーケンスを非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進めます。 (継承元 Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	現在のストリームからバイトシーケンスを非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進め、キャンセル要求を監視します。 (継承元 Stream)
ReadAsync(Memory<Byte>, CancellationToken)	現在のストリームからバイトシーケンスを非同期に読み取り、読み取ったバイト数だけストリーム内の位置を進め、キャンセル要求を監視します。 (継承元 Stream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	現在のストリームから少なくとも最小バイト数を読み取り、ストリーム内の位置を読み取ったバイト数だけ進めます。 (継承元 Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	現在のストリームから少なくとも最小バイト数を非同期に読み取り、読み取ったバイト数でストリーム内の位置を進め、取り消し要求を監視します。 (継承元 Stream)
ReadByte()	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。
ReadByte()	ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。 (継承元 Stream)
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)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込んだバイト数だけストリーム内の現在位置を進めます。 (継承元 Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込んだバイト数だけストリーム内の現在位置を進め、キャンセル要求を監視します。 (継承元 Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	現在のストリームにバイトシーケンスを非同期に書き込み、書き込んだバイト数だけストリーム内の現在位置を進め、キャンセル要求を監視します。 (継承元 Stream)
WriteByte(Byte)	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。
WriteByte(Byte)	ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。 (継承元 Stream)

拡張メソッド

CopyToAsync(Stream, PipeWriter, CancellationToken)	キャンセルトークンを使用して、Stream からバイトを非同期で読み取り、指定した PipeWriter に書き込みます。
AsInputStream(Stream)	Windows ストアアプリ用 .NET のマネージドストリームを Windows ランタイムの入力ストリームに変換します。
AsOutputStream(Stream)	Windows ストアアプリ用 .NET のマネージドストリームを Windows ランタイムの出力ストリームに変換します。
AsRandomAccessStream(Stream)	特定のストリームをランダムアクセスストリームに変換します。

適用対象