다음을 통해 공유


FileStream.Handle 속성

정의

주의

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

현재 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

속성 값

IntPtr

nativeint

FileStream 개체가 캡슐화할 파일에 대한 운영 체제 파일 핸들입니다. FileStream이 닫혀 있는 경우에는 -1입니다.

특성

예외

호출자에게 필요한 권한이 없는 경우

설명

이 속성은 운영 체제 제공 시스템 호출(예: ReadFile Windows)에 사용하기 위한 운영 체제 핸들입니다. 와 같은 fread파일 설명자를 예상하는 C 라이브러리 함수에서는 작동하지 않습니다.

어떤 생성자가 호출되었는지에 따라 운영 체제 핸들이 동기적으로 또는 비동기적으로 열렸을 FileStream 수 있습니다. 속성을 IsAsync 사용하여 이 핸들이 비동기적으로 열렸는지 여부를 검색합니다. Win32에서 이는 겹치는 IO에 대해 핸들이 열렸으며 및 WriteFile에 대한 다른 매개 변수가 필요하다는 것을 ReadFile 의미합니다.

주의

가 만들어지고, 핸들이 전달되고, 일부 작업이 핸들의 파일 포인터를 이동한 다음 FileStream 가 다시 사용되는 경우 FileStream 데이터 손상이 발생할 수 있습니다. 여러 스레드가 동일한 파일에 동시에 안전하게 쓸 수 없으며 FileStream 버퍼링 코드는 핸들을 단독으로 제어한다고 가정합니다. FileStream는 다른 프로세스에서 파일 포인터를 이동했음을 감지하면 FileStream 을 throw IOException 할 수 있습니다. 이 문제를 방지하려면 버퍼링되었을 수 있는 파일의 일부에 데이터를 쓰지 말고 메서드가 FileStream 에서 FileStream마지막으로 호출되었을 때의 위치에 대한 파일 포인터를 복원합니다.

적용 대상

추가 정보