FileStream.Handle プロパティ

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

FileStream.cs

注意事項

FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.

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

public:
 virtual property IntPtr Handle { IntPtr get(); };

[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }

[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint

Public Overridable ReadOnly Property Handle As IntPtr

プロパティ値

IntPtr

nativeint

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

属性

ObsoleteAttribute

例外

SecurityException

呼び出し元に、必要なアクセス許可がありません。

注釈

このプロパティは、オペレーティング システムが提供するシステム呼び出し (Windows など ReadFile ) で使用するためのオペレーティング システム ハンドルです。 これは、 などの freadファイル記述子を必要とする C ライブラリ関数では機能しません。

オペレーティング システム ハンドルは、呼 FileStream び出されたコンストラクターに応じて、同期または非同期で開かれた可能性があります。 プロパティを IsAsync 使用して、このハンドルが非同期的に開かれたかどうかを検出します。 Win32 では、これは、重複する IO 用にハンドルが開かれたこと、および に対して異なるパラメーターが必要な場合を ReadFile 意味します WriteFile。

注意事項

が作成され、そのハンドルが渡され、何らかの操作によってハンドルのファイル ポインターが移動されFileStream、 が再度使用されると、データ破損が発生FileStreamする可能性があります。 複数のスレッドが同じファイルに同時に安全に書き込むことができず、 FileStream バッファー コードはハンドルを排他的に制御することを前提としています。 FileStream は、 IOException 他のプロセスがファイル ポインターを移動したことを検出した場合 FileStream に をスローする可能性があります。 これを回避するには、バッファーに格納されている可能性があるファイル FileStream の一部にデータを書き込まず、メソッドが で最後に呼び出 FileStreamされたときの場所にファイル ポインターを復元します。

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み