SafeHandle.IsInvalid 속성

정의

네임스페이스:

System.Runtime.InteropServices

어셈블리:

System.Runtime.dll

Source:

SafeHandle.cs

파생 클래스에서 재정의된 경우 핸들 값이 잘못되었는지 여부를 나타내는 값을 가져옵니다.

public:
 abstract property bool IsInvalid { bool get(); };

public abstract bool IsInvalid { get; }

member this.IsInvalid : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

속성 값

Boolean

핸들 값이 잘못되었으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 파일이 성공적으로 열렸는지 확인합니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 SafeHandle 클래스입니다.

// Determine if file is opened successfully.
if (_handle.IsInvalid)
    throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);

설명

파생 클래스는 공용 언어 런타임에서 IsInvalid 중요한 종료가 필요한지 여부를 결정할 수 있도록 속성을 구현해야 합니다. 파생 클래스는 지원하는 일반적인 유형의 핸들에 맞는 구현을 제공해야 합니다(0 또는 -1이 잘못됨). 그런 다음 이러한 클래스는 특정 안전 핸들 형식에 대해 추가로 파생될 수 있습니다.

개체가 IsClosed 기본 핸들을 사용하여 완료되었는지 여부를 SafeHandle 보고하는 속성과 달리 속성은 지정된 핸들 IsInvalid 값이 항상 유효하지 않은 것으로 간주되는지 여부를 계산합니다. 따라서 속성은 IsInvalid 항상 하나의 핸들 값에 대해 동일한 값을 반환합니다.