InvalidCastException Class
AccessViolationException Class
Action Delegate
Action(T) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16) Delegate
Action(T1, T2) Delegate
Action(T1, T2, T3) Delegate
Action(T1, T2, T3, T4) Delegate
Action(T1, T2, T3, T4, T5) Delegate
Action(T1, T2, T3, T4, T5, T6) Delegate
Action(T1, T2, T3, T4, T5, T6, T7) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8) Delegate
Action(T1, T2, T3, T4, T5, T6, T7, T8, T9) Delegate
Activator Class
AggregateException Class
AppDomain Class
AppDomainManager Class
AppDomainSetup Class
AppDomainUnloadedException Class
ApplicationException Class
ArgumentException Class
ArgumentNullException Class
ArgumentOutOfRangeException Class
ArithmeticException Class
Array Class
ArraySegment(T) Structure
ArrayTypeMismatchException Class
AsyncCallback Delegate
Attribute Class
AttributeTargets Enumeration
AttributeUsageAttribute Class
BadImageFormatException Class
BitConverter Class
Boolean Structure
Buffer Class
Byte Structure
CannotUnloadAppDomainException Class
Char Structure
CLSCompliantAttribute Class
Comparison(T) Delegate
Console Class
ContextStaticAttribute Class
Convert Class
Converter(TInput, TOutput) Delegate
DataMisalignedException Class
DateTime Structure
DateTimeKind Enumeration
DateTimeOffset Structure
DayOfWeek Enumeration
DBNull Class
Decimal Structure
Delegate Class
DivideByZeroException Class
DllNotFoundException Class
Double Structure
EntryPointNotFoundException Class
Enum Class
Environment Class
Environment.SpecialFolder Enumeration
EventArgs Class
EventHandler Delegate
EventHandler(TEventArgs) Delegate
Exception Class
ExecutionEngineException Class
FieldAccessException Class
FileStyleUriParser Class
FlagsAttribute Class
FormatException Class
FtpStyleUriParser Class
Func(TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16, TResult) Delegate
Func(T, TResult) Delegate
Func(T1, T2, TResult) Delegate
Func(T1, T2, T3, TResult) Delegate
Func(T1, T2, T3, T4, TResult) Delegate
Func(T1, T2, T3, T4, T5, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, TResult) Delegate
Func(T1, T2, T3, T4, T5, T6, T7, T8, TResult) Delegate
GC Class
GCCollectionMode Enumeration
GenericUriParser Class
GenericUriParserOptions Enumeration
Guid Structure
HttpStyleUriParser Class
IAsyncResult Interface
IComparable Interface
IComparable(T) Interface
IConvertible Interface
ICustomFormatter Interface
IDisposable Interface
IEquatable(T) Interface
IFormatProvider Interface
IFormattable Interface
IndexOutOfRangeException Class
Int16 Structure
Int32 Structure
Int64 Structure
IntPtr Structure
InvalidCastException Class
InvalidCastException Constructor
InvalidCastException Methods
InvalidCastException Properties
InvalidOperationException Class
InvalidProgramException Class
InvalidTimeZoneException Class
IObservable(T) Interface
IObserver(T) Interface
IProgress(T) Interface
IServiceProvider Interface
Lazy(T) Class
Lazy(T, TMetadata) Class
LoaderOptimization Enumeration
Math Class
MemberAccessException Class
MethodAccessException Class
MidpointRounding Enumeration
MissingFieldException Class
MissingMemberException Class
MissingMethodException Class
MTAThreadAttribute Class
MulticastDelegate Class
MulticastNotSupportedException Class
NotFiniteNumberException Class
NotImplementedException Class
NotSupportedException Class
Nullable Class
Nullable(T) Structure
NullReferenceException Class
Object Class
ObjectDisposedException Class
ObsoleteAttribute Class
OperatingSystem Class
OperationCanceledException Class
OutOfMemoryException Class
OverflowException Class
ParamArrayAttribute Class
PlatformID Enumeration
PlatformNotSupportedException Class
Predicate(T) Delegate
Progress(T) Class
Random Class
RankException Class
ResolveEventArgs Class
ResolveEventHandler Delegate
RuntimeArgumentHandle Structure
RuntimeFieldHandle Structure
RuntimeMethodHandle Structure
RuntimeTypeHandle Structure
SByte Structure
Single Structure
StackOverflowException Class
STAThreadAttribute Class
String Class
StringComparer Class
StringComparison Enumeration
StringSplitOptions Enumeration
SystemException Class
ThreadStaticAttribute Class
TimeoutException Class
TimeSpan Structure
TimeZoneInfo Class
Tuple Class
Tuple(T1) Class
Tuple(T1, T2) Class
Tuple(T1, T2, T3) Class
Tuple(T1, T2, T3, T4) Class
Tuple(T1, T2, T3, T4, T5) Class
Tuple(T1, T2, T3, T4, T5, T6) Class
Tuple(T1, T2, T3, T4, T5, T6, T7) Class
Tuple(T1, T2, T3, T4, T5, T6, T7, TRest) Class
Type Class
TypeAccessException Class
TypeCode Enumeration
TypeInitializationException Class
TypeLoadException Class
UInt16 Structure
UInt32 Structure
UInt64 Structure
UIntPtr Structure
UnauthorizedAccessException Class
UnhandledExceptionEventArgs Class
UnhandledExceptionEventHandler Delegate
Uri Class
UriBuilder Class
UriComponents Enumeration
UriFormat Enumeration
UriFormatException Class
UriHostNameType Enumeration
UriIdnScope Enumeration
UriKind Enumeration
UriParser Class
UriTypeConverter Class
ValueType Class
Version Class
Void Structure
WeakReference Class
WeakReference(T) Class
WindowsRuntimeSystemExtensions Class
TOC
Collapse the table of content
Expand the table of content

InvalidCastException Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

The exception that is thrown for invalid casting or explicit conversion.

System::Object
  System::Exception
    System::SystemException
      System::InvalidCastException

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

The InvalidCastException type exposes the following members.

  NameDescription
Public methodInvalidCastException()Initializes a new instance of the InvalidCastException class.
Public methodInvalidCastException(String)Initializes a new instance of the InvalidCastException class with a specified error message.
Public methodInvalidCastException(String, Exception)Initializes a new instance of the InvalidCastException class with a specified error message and a reference to the inner exception that is the cause of this exception.
Public methodInvalidCastException(String, Int32)Initializes a new instance of the InvalidCastException class with a specified message and error code.
Top

  NameDescription
Public propertyDataGets a collection of key/value pairs that provide additional user-defined information about the exception. (Inherited from Exception.)
Public propertyHelpLinkGets or sets a link to the help file associated with this exception. (Inherited from Exception.)
Public propertyHResultGets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Inherited from Exception.)
Public propertyInnerExceptionGets the Exception instance that caused the current exception. (Inherited from Exception.)
Public propertyMessageGets a message that describes the current exception. (Inherited from Exception.)
Public propertySourceGets or sets the name of the application or the object that causes the error. (Inherited from Exception.)
Public propertyStackTraceGets a string representation of the frames on the call stack at the time the current exception was thrown. (Inherited from Exception.)
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetBaseExceptionWhen overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Inherited from Exception.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the runtime type of the current instance. (Inherited from Exception.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringCreates and returns a string representation of the current exception. (Inherited from Exception.)
Top

InvalidCastException is thrown if:

  • For a conversion from a Single or a Double to a Decimal, the source value is infinity, Not-a-Number (NaN), or too large to be represented as the destination type.

  • A failure occurs during an explicit reference conversion.

For an explicit reference conversion to be successful, the source value must be nullptr, or the object type referenced by the source argument must be convertible to the destination type by an implicit reference conversion.

For information on conversions supported by the system, see the Convert class. For errors that occur when the destination type can store source type values, but is not large enough to store a specific source value, see OverflowException exception.

The following Microsoft intermediate language (MSIL) instructions throw InvalidCastException

  • castclass

  • refanyval

  • unbox

For a list of initial property values for an instance of InvalidCastException, see the InvalidCastException constructors.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Show:
© 2017 Microsoft