FileStream.Handle 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
주의
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; }[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("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[<System.Obsolete("This property has been deprecated. Please use FileStream's SafeFileHandle property instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Handle : nativeintmember 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 : nativeintPublic Overridable ReadOnly Property Handle As IntPtr속성 값
-
IntPtr
nativeint
이 FileStream 개체가 캡슐화할 파일에 대한 운영 체제 파일 핸들입니다. FileStream이 닫혀 있는 경우에는 -1입니다.
- 특성
예외
호출자에게 필요한 권한이 없는 경우
설명
이 속성은 운영 체제 제공 시스템 호출(예: ReadFile Windows)에 사용하기 위한 운영 체제 핸들입니다. 파일 설명자를 예상하는 C 라이브러리 함수에서는 작동하지 않습니다(예: fread.).
호출된 생성자에 따라 운영 체제 핸들이 동기적으로 또는 비동기적으로 열렸을 FileStream 수 있습니다. 이 핸들이 IsAsync 비동기적으로 열렸는지 여부를 검색하려면 이 속성을 사용합니다. Win32에서 이는 핸들이 겹치는 IO에 대해 열렸으며 서로 다른 매개 변수 ReadFile WriteFile가 필요하다는 것을 의미합니다.
주의
데이터가 손상되면 해당 핸들이 전달되고, 일부 작업이 핸들의 파일 포인터를 이동한 다음 FileStream 다시 사용되는 경우 FileStream 데이터가 손상될 수 있습니다. 여러 스레드가 동일한 파일에 동시에 안전하게 쓸 수 없으며 FileStream 버퍼링 코드는 핸들만 제어한다고 가정합니다. FileStream 는 다른 프로세스에서 IOException 파일 포인터를 이동했음을 감지하는 경우 FileStream throw될 수 있습니다. 이 문제를 방지하려면 버퍼링되었을 수 있는 FileStream 파일의 일부에 데이터를 쓰지 말고 메서드가 마지막으로 호출 FileStream되었을 때의 위치에 대한 파일 포인터를 복원합니다.