FileStream.Handle プロパティ

.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

C#

[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 ();
}

J#

/** @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 でメソッドを最後に呼び出したときの位置にファイル ポインタを戻してください。

.NET Framework のセキュリティ

• SecurityPermission  (PInvoke または COM 統合によるネイティブ コードの呼び出しなど、アンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む