Bagikan melalui


FileStream.Handle Properti

Definisi

Perhatian

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

Perhatian

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

Perhatian

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

Mendapatkan handel file sistem operasi untuk file yang dienkapsulasi objek saat ini 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; }
[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; }
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("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
[<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
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
Public Overridable ReadOnly Property Handle As IntPtr

Nilai Properti

IntPtr

nativeint

Handel file sistem operasi untuk file yang dienkapsulasi oleh objek ini FileStream , atau -1 jika FileStream telah ditutup.

Atribut

Pengecualian

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

Properti ini adalah handel sistem operasi untuk digunakan dengan panggilan sistem yang disediakan sistem operasi (seperti ReadFile pada Windows). Ini tidak akan berfungsi dengan fungsi pustaka C yang mengharapkan pendeskripsi file, seperti fread.

Handel sistem operasi mungkin telah dibuka secara sinkron atau asinkron, tergantung pada konstruktor mana yang FileStream dipanggil. IsAsync Gunakan properti untuk menemukan apakah handel ini dibuka secara asinkron. Di Win32, ini berarti handel dibuka untuk IO yang tumpang tindih, dan membutuhkan parameter yang berbeda ke ReadFile dan WriteFile.

Perhatian

Kerusakan data mungkin terjadi jika FileStream dibuat, handelnya diteruskan, beberapa operasi memindahkan penunjuk file handel, lalu FileStream digunakan lagi. Beberapa utas tidak dapat menulis dengan aman ke file yang sama secara bersamaan, dan FileStream kode buffering mengasumsikan bahwa ia secara eksklusif mengontrol handel. FileStream mungkin melempar IOException jika FileStream mendeteksi bahwa beberapa proses lain telah memindahkan penunjuk file. Untuk menghindari hal ini, jangan menulis data apa pun ke dalam sebagian file yang FileStream mungkin telah di-buffer, dan memulihkan penunjuk file ke lokasi yang dimilikinya ketika metode terakhir dipanggil pada FileStream.

Berlaku untuk

Lihat juga