FileStream.Handle 屬性

  • 參考

定義

命名空間:
System.IO
組件:
System.Runtime.dll
組件:
netstandard.dll
組件:
mscorlib.dll

警告

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. https://go.microsoft.com/fwlink/?linkid=14202

警告

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

警告

This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202

警告

Use SafeFileHandle instead

取得目前 FileStream 物件封裝之檔案的作業系統檔案控制代碼。

public:
 virtual property IntPtr Handle { IntPtr get(); };
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { get; }
[System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual IntPtr Handle { [System.Security.SecurityCritical] get; }
[System.Obsolete("Use SafeFileHandle instead")]
public virtual IntPtr Handle { get; }
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeint
[<System.Obsolete("This property has been deprecated.  Please use FileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
[<get: System.Security.SecurityCritical>]
member this.Handle : nativeint
[<System.Obsolete("Use SafeFileHandle instead")>]
member this.Handle : nativeint
Public Overridable ReadOnly Property Handle As IntPtr

屬性值

IntPtr

nativeint

這個 FileStream 物件所封裝的檔案之作業系統檔案控制代碼；如果 FileStream 已關閉，則為 -1。

屬性
ObsoleteAttribute SecurityCriticalAttribute

例外狀況

SecurityException

呼叫端沒有必要的權限。

備註

這個屬性是作業系統的控制碼，可用於作業系統提供的系統呼叫 (例如 ReadFile Windows) 。 它無法與預期檔案描述項的 C 程式庫函式搭配使用，例如 fread 。

作業系統控制碼可能會以同步或非同步方式開啟，視呼叫的函式而定 FileStream 。 您 IsAsync 可以使用屬性來探索這個控制碼是否以非同步方式開啟。 在 Win32 中，這表示已針對重迭的 IO 開啟控制碼，而且需要不同的參數給 ReadFile 和 WriteFile 。

警告

如果已建立，則可能會發生資料損毀、 FileStream 已通過控制碼、某些作業會移動控點的檔案指標，然後再 FileStream 使用。 多個執行緒無法安全地同時寫入相同的檔案，而 FileStream 緩衝程式碼則假設它專門控制控制碼。 FileStreamIOException如果 FileStream 偵測到某個其他進程已移動檔案指標，可能會擲回。 若要避免這種情況，請不要將任何資料寫入至可能已緩衝處理的檔案中 FileStream ，並將檔案指標還原到最後一次呼叫方法時的位置 FileStream 。

適用於

另請參閱