FileStream.Handle Özellik

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
FileStream.cs
Kaynak:
FileStream.cs
Kaynak:
FileStream.cs

Dikkat

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

Dikkat

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

Dikkat

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

Geçerli FileStream nesnenin kapsüllediğini dosyanın işletim sistemi dosya tanıtıcısını alır.

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

Özellik Değeri

IntPtr

nativeint

Bu FileStream nesne tarafından kapsüllenen dosyanın işletim sistemi dosya tanıtıcısı veya kapatılmışsa FileStream -1.

Öznitelikler
ObsoleteAttribute SecurityCriticalAttribute

Özel durumlar

SecurityException

Çağıranın gerekli izni yok.

Açıklamalar

Bu özellik, işletim sistemi tarafından sağlanan sistem çağrılarıyla (örneğin ReadFile , Windows'da) kullanılmak üzere bir işletim sistemi tanıtıcısıdır. gibi freadbir dosya tanımlayıcısı bekleyen C kitaplığı işlevleriyle çalışmaz.

İşletim sistemi tanıtıcısı, hangi FileStream oluşturucunun çağrıldığına bağlı olarak zaman uyumlu veya zaman uyumsuz olarak açılmış olabilir. Bu tanıtıcının IsAsync zaman uyumsuz olarak açılıp açılmadığını bulmak için özelliğini kullanın. Win32'de bu, tanıtıcının çakışan GÇ için açıldığı ve ve WriteFileiçin ReadFile farklı parametreler gerektirdiği anlamına gelir.

Dikkat

Bir oluşturulursa, tanıtıcısı geçirilirse FileStream , bazı işlemler tanıtıcının dosya işaretçisini taşırsa ve sonra FileStream yeniden kullanılırsa veri bozulması oluşabilir. Birden çok iş parçacığı aynı dosyaya aynı anda güvenli bir şekilde yazamaz ve FileStream arabelleğe alınan kod, tanıtıcıyı özel olarak denetlediğini varsayar. FileStream başka bir işlemin dosya işaretçisini taşıdığını algılarsa bir IOExceptionFileStream atabilir. Bunu önlemek için, dosyanın FileStream arabelleğe alınmış olabilecek bir bölümüne veri yazmayın ve dosya işaretçisini yöntemler en son üzerinde çağrıldığında FileStreambulunduğu konuma geri yükleyin.

Şunlara uygulanır

Ayrıca bkz.