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