이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보

번역

원본

이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

InvalidCastException 클래스

.NET Framework 4.5

다른 버전

잘못된 캐스팅 또는 명시적 변환에 대해 throw되는 예외입니다.

상속 계층 구조

System.Object
  System.Exception
    System.SystemException
      System.InvalidCastException

네임스페이스: System
어셈블리: mscorlib(mscorlib.dll)

구문

C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class InvalidCastException : SystemException

InvalidCastException 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	설명
	InvalidCastException()	InvalidCastException 클래스의 새 인스턴스를 초기화합니다.
	InvalidCastException(String)	지정된 오류 메시지를 사용하여 InvalidCastException 클래스의 새 인스턴스를 초기화합니다.
	InvalidCastException(SerializationInfo, StreamingContext)	serialize된 데이터를 사용하여 InvalidCastException 클래스의 새 인스턴스를 초기화합니다.
	InvalidCastException(String, Exception)	지정된 오류 메시지와 해당 예외의 근본 원인인 내부 예외에 대한 참조를 사용하여 InvalidCastException 클래스의 새 인스턴스를 초기화합니다.
	InvalidCastException(String, Int32)	지정된 메시지와 오류 코드를 사용하여 InvalidCastException 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

	이름	설명
	Data	예외에 대한 사용자 정의 추가 정보를 제공하는 키/값 쌍의 컬렉션을 가져옵니다. (Exception에서 상속됨)
	HelpLink	이 예외와 관련된 도움말 파일에 대한 링크를 가져오거나 설정합니다. (Exception에서 상속됨)
	HResult	특정 예외에 할당된 코드화된 숫자 값인 HRESULT를 가져오거나 설정합니다. (Exception에서 상속됨)
	InnerException	현재 예외를 발생시킨 Exception 인스턴스를 가져옵니다. (Exception에서 상속됨)
	Message	현재 예외를 설명하는 메시지를 가져옵니다. (Exception에서 상속됨)
	Source	오류를 발생시키는 응용 프로그램 또는 개체의 이름을 가져오거나 설정합니다. (Exception에서 상속됨)
	StackTrace	호출 스택의 직접 실행 프레임에 대한 문자열 표현을 가져옵니다. (Exception에서 상속됨)
	TargetSite	현재 예외를 throw하는 메서드를 가져옵니다. (Exception에서 상속됨)

위쪽

메서드

	이름	설명
	Equals(Object)	지정한 개체와 현재 개체가 같은지 여부를 확인합니다. (Object에서 상속됨)
	Finalize	가비지 수집자 에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetBaseException	파생 클래스에서 재정의되었을 때, 하나 이상의 후속 예외의 근본 원인이 되는 Exception을 반환합니다. (Exception에서 상속됨)
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
	GetObjectData	파생 클래스에서 재정의될 때, 예외에 관한 정보를 SerializationInfo에 설정합니다. (Exception에서 상속됨)
	GetType	현재 인스턴스의 런타임 형식을 가져옵니다. (Exception에서 상속됨) XNA Framework 3.0에서 이 멤버는 Object에서 상속됩니다..GetType(). 이식 가능한 클래스 라이브러리 이식 가능한 클래스 라이브러리에서 이 멤버는 Object에서 상속됩니다..GetType(). Windows 스토어 앱용 .NET Windows 8에서 이 멤버는 Object에서 상속됩니다..GetType().
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	ToString	현재 예외에 대한 문자열 표현을 만들고 반환합니다. (Exception에서 상속됨)

위쪽

이벤트

	이름	설명
	SerializeObjectState	예외에 대한 serialize된 데이터가 들어 있는 예외 상태 개체가 만들어지도록 예외가 serialize될 때 발생합니다. (Exception에서 상속됨)

위쪽

설명

InvalidCastException 은 다음과 같은 경우에 throw됩니다.

Single 또는 Double에서 Decimal로 변환할 때 소스 값이 무한대 또는 NaN(Not-a-Number)이거나 너무 커서 대상 형식으로 표현할 수 없는 경우
명시적 참조 변환 시 오류가 발생하는 경우

명시적 참조 변환이 올바르게 수행되려면 소스 값이 null이거나 소스 인수에서 참조하는 개체 형식을 암시적 참조 변환을 통해 대상 형식으로 변환할 수 있어야 합니다.

시스템에서 지원하는 변환에 대한 내용은 Convert 클래스를 참조하십시오. 대상 형식이 소스 형식 값을 저장할 수 있으나 특정 소스 값을 저장할 공간이 부족할 때 발생하는 오류에 대한 내용은 OverflowException 예외를 참조하십시오.

다음 MSIL(Microsoft Intermediate Language) 명령은 InvalidCastException을 throw합니다.

castclass
refanyval
unbox

InvalidCastException 은 0x80004002 값을 가지는 HRESULT COR_E_INVALIDCAST를 사용합니다.

InvalidCastException 인스턴스의 초기 속성 값 목록에 대한 자세한 내용은 InvalidCastException 생성자를 참조하십시오.

버전 정보

.NET Framework

4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

이식 가능한 클래스 라이브러리

이식 가능한 클래스 라이브러리에서 지원

Windows 스토어 앱용 .NET

Windows 8에서 지원

플랫폼

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

System 네임스페이스

Exception

기타 리소스

예외 처리 및 Throw

이 정보가 도움이 되었습니까? 예 아니요

정확하지 않음

내용이 심층적이지 않음

코드 예가 더 필요함

번역에 개선이 필요함

(1500자 남음)

커뮤니티 추가 항목

추가