FileStream.Handle プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

FileStream.Handle プロパティ

メモ : このプロパティは、互換性のために残されています。

現在の FileStream オブジェクトによってカプセル化されるファイルのオペレーティングシステムファイルハンドルを取得します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ObsoleteAttribute("This property has been deprecated.
  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Overridable ReadOnly
 Property Handle As IntPtr

Visual Basic (使用法)

Dim instance As FileStream
Dim value As IntPtr

value = instance.Handle

[ObsoleteAttribute("This property has been deprecated.  Please use FileStream\'s
 SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public virtual IntPtr Handle { get; }

C++

[ObsoleteAttribute(L"This property has been deprecated.  Please use FileStream\'s
 SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
virtual property IntPtr Handle {
    IntPtr get ();
}

/** @property */
public IntPtr get_Handle ()

JScript

public function get Handle
 () : IntPtr

プロパティ値
この FileStream オブジェクトによってカプセル化されるファイルのオペレーティングシステムファイルハンドル。または FileStream が閉じられている場合は -1。

例外

例外の種類	条件
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

このプロパティは、オペレーティングシステムに用意されているシステムコール (Windows では ReadFile など) で使用するオペレーティングシステムハンドルです。この場合、fread などのファイル記述子を要求する C ライブラリ関数では動作しません。

オペレーティングシステムハンドルは、どの FileStream コンストラクタを呼び出したかによって、同期的または非同期的に開かれます。このハンドルが非同期的に開かれたかどうかを調べるには IsAsync プロパティを使用します。Win32 では、重複 I/O 用にハンドルが開かれ、ReadFile と WriteFile で異なるパラメータが要求されます。

注意
FileStream を作成し、そのハンドルを渡し、なんらかの操作によってハンドルのファイルポインタを移動してから、FileStream を再び使用した場合、データが破損することがあります。複数のスレッドは、同時に同じファイルに対して安全な書き込みを行うことはできません。FileStream バッファコードは、そのハンドルを排他的に制御していることを前提にしています。FileStream が他のプロセスによってファイルのポインタが移動されたことを検出した場合、FileStream は IOException をスローすることがあります。これを防ぐには、FileStream がバッファに格納した可能性があるファイルの部分にデータを書き込まないでください。また、その FileStream でメソッドを最後に呼び出したときの位置にファイルポインタを戻してください。