Type.ReflectionOnlyGetType(String, Boolean, Boolean) Metod

Definition

Namnområde:
System
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll
Källa:
Type.cs
Källa:
Type.cs
Källa:
Type.cs
Källa:
Type.cs
Källa:
Type.cs

Varning

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Type Hämtar med det angivna namnet och anger om en skiftlägeskänslig sökning ska utföras och om ett undantag ska utlösas om typen inte hittas. Typen läses bara in för reflektion, inte för körning.

public:
 static Type ^ ReflectionOnlyGetType(System::String ^ typeName, bool throwIfNotFound, bool ignoreCase);
[System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static Type? ReflectionOnlyGetType(string typeName, bool throwIfNotFound, bool ignoreCase);
public static Type? ReflectionOnlyGetType(string typeName, bool throwIfNotFound, bool ignoreCase);
public static Type ReflectionOnlyGetType(string typeName, bool throwIfNotFound, bool ignoreCase);
[<System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member ReflectionOnlyGetType : string * bool * bool -> Type
static member ReflectionOnlyGetType : string * bool * bool -> Type
Public Shared Function ReflectionOnlyGetType (typeName As String, throwIfNotFound As Boolean, ignoreCase As Boolean) As Type

Parametrar

typeName
String

Det sammansättningskvalificerade namnet på det som ska hämtas Type .

throwIfNotFound
Boolean

true för att utlösa en TypeLoadException om typen inte kan hittas, false för att returnera null om typen inte kan hittas. Om du false anger utelämnas även vissa andra undantagsvillkor, men inte alla. Se avsnittet Undantag.

ignoreCase
Boolean

trueför att utföra en skiftlägeskänslig sökning efter ; för typeNameatt utföra en skiftlägeskänslig sökning efter false. typeName

Returer

Type

Typen med det angivna namnet, om det hittas; annars . null Om typen inte hittas anger parametern throwIfNotFound om null returneras eller om ett undantag genereras. I vissa fall genereras ett undantag oavsett värdet throwIfNotFoundför . Se avsnittet Undantag.

Attribut
ObsoleteAttribute

Undantag

ArgumentNullException

typeName är null.

TargetInvocationException

En klassinitierare anropas och utlöser ett undantag.

TypeLoadException

throwIfNotFound är true och typen hittades inte.

-eller-

throwIfNotFound är true och typeName innehåller ogiltiga tecken, till exempel en inbäddad flik.

-eller-

throwIfNotFound är true och typeName är en tom sträng.

-eller-

throwIfNotFound är true och typeName representerar en matristyp med en ogiltig storlek.

-eller-

typeName representerar en matris med TypedReference objekt.

ArgumentException

typeName innehåller inte sammansättningsnamnet.

-eller-

throwIfNotFound är true och typeName innehåller ogiltig syntax, till exempel "MyType[,*,]".

-eller-

typeName representerar en allmän typ som har en pekartyp, en ByRef typ eller Void som ett av dess typargument.

-eller-

typeName representerar en allmän typ som har ett felaktigt antal typargument.

-eller-

typeName representerar en allmän typ och ett av dess typargument uppfyller inte begränsningarna för motsvarande typparameter.

FileNotFoundException

throwIfNotFound är true och sammansättningen eller något av dess beroenden hittades inte.

FileLoadException

Sammansättningen eller något av dess beroenden hittades, men kunde inte läsas in.

BadImageFormatException

Sammansättningen eller något av dess beroenden är inte en giltig sammansättning för den inlästa körningen.

PlatformNotSupportedException

.NET Core och .NET endast 5+ : I samtliga fall.

Kommentarer

Om sammansättningen som innehåller typen inte redan har lästs in i kontexten ReflectionOnlyGetType för endast reflektion motsvarar användningen av metoden att först läsa in sammansättningen endast för reflektion med hjälp av ReflectionOnlyLoad metoden och sedan läsa in typen genom att anropa sammansättningens Assembly.GetType metod. Information om sammansättningskvalificerade namn finns i egenskapen Type.AssemblyQualifiedName . Mer information om hur du anger typnamn finns i metodens GetType(String, Boolean, Boolean) överlagring.

Om sammansättningen redan har lästs in för körning läses en annan kopia in i kontexten endast reflektion.

Parametern throwIfNotFound anger vad som händer när typen inte hittas och undertrycker även vissa andra undantagsvillkor enligt beskrivningen i avsnittet Undantag. Vissa undantag utlöses oavsett värdet throwIfNotFoundför . Om sammansättningen till exempel inte är giltig genereras en BadImageFormatException även om throwIfNotFound är false.

Mer information om hur du använder kontexten endast för reflektion finns i How to: Load Assemblies into the Reflection-Only Context (Läs in sammansättningar i Reflection-Only Context).

Gäller för

Se även