FileStream.Handle 속성

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

Source:

FileStream.cs

주의

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

현재 FileStream 개체가 캡슐화할 파일에 대한 운영 체제 파일 핸들을 가져옵니다.

public:
 virtual property IntPtr Handle { IntPtr get(); };

[System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")]
public virtual IntPtr Handle { get; }

[<System.Obsolete("FileStream.Handle has been deprecated. Use FileStream's SafeFileHandle property instead.")>]
member this.Handle : nativeint

Public Overridable ReadOnly Property Handle As IntPtr

속성 값

IntPtr

nativeint

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

특성

ObsoleteAttribute

예외

SecurityException

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

설명

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

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

주의

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

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기