Type.ReflectionOnlyGetType(String, Boolean, Boolean) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Type.cs

Dikkat

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Type Büyük/küçük harfe duyarlı bir arama yapılıp yapılmayacağını ve tür bulunamazsa özel durum oluşturup oluşturmayacağını belirterek belirtilen ada sahip değerini alır. Tür, yürütme için değil yalnızca yansıma için yüklenir.

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);

[<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

Public Shared Function ReflectionOnlyGetType (typeName As String, throwIfNotFound As Boolean, ignoreCase As Boolean) As Type

Parametreler

typeName

String

Alınacak derlemenin Type tam adı.

throwIfNotFound

Boolean

true türü bulunamazsa bir TypeLoadException oluşturmak; false tür bulunamazsa döndürmek null için. Belirtme, false diğer bazı özel durum koşullarını da bastırır, ancak bunların tümünü engellemez. Özel Durumlar bölümüne bakın.

ignoreCase

Boolean

true için büyük/küçük harfe duyarlı olmayan bir arama yapmak için typeName; false için büyük/küçük harfe duyarlı bir arama gerçekleştirmek için typeName.

Döndürülenler

Type

Bulunursa belirtilen ada sahip tür; aksi takdirde , null. Tür bulunamazsa, throwIfNotFound parametresi döndürülür veya null bir özel durum oluşturulur belirtir. Bazı durumlarda, değerinden throwIfNotFoundbağımsız olarak bir özel durum oluşturulur. Özel Durumlar bölümüne bakın.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

typeName, null değeridir.

TargetInvocationException

Sınıf başlatıcısı çağrılır ve bir özel durum oluşturulur.

TypeLoadException

throwIfNotFound ve true türü bulunamadı.

-veya-

throwIfNotFound typeName ve true ekli sekme gibi geçersiz karakterler içeriyor.

-veya-

throwIfNotFound ve truetypeName boş bir dizedir.

-veya-

throwIfNotFound , true ve typeName geçersiz boyuta sahip bir dizi türünü temsil eder.

-veya-

typeName bir nesne dizisini TypedReference temsil eder.

ArgumentException

typeName derleme adını içermez.

-veya-

throwIfNotFound typeName ve true geçersiz söz dizimi içeriyor; örneğin, "MyType[,*,]".

-veya-

typeName, işaretçi türü, tür veya Void tür bağımsız değişkenlerinden biri olan genel bir ByRef türü temsil eder.

-veya-

typeName , yanlış sayıda tür bağımsız değişkeni olan genel bir türü temsil eder.

-veya-

typeName genel bir türü temsil eder ve tür bağımsız değişkenlerinden biri ilgili tür parametresinin kısıtlamalarını karşılamaz.

FileNotFoundException

throwIfNotFound ve true derleme veya bağımlılıklarından biri bulunamadı.

FileLoadException

Derleme ya da bağımlılıklarından biri bulundu, ancak yüklenemedi.

BadImageFormatException

Derleme veya bağımlılıklarından biri şu anda yüklü olan çalışma zamanı için geçerli bir derleme değil.

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : Her durumda.

Açıklamalar

Türü içeren derleme henüz yalnızca yansıma bağlamı içine yüklenmemişse, yönteminin kullanılması ReflectionOnlyGetType ilk olarak yalnızca yansıma için derlemeyi yüklemeye, yöntemini kullanmaya ve sonra derlemenin ReflectionOnlyLoadAssembly.GetType yöntemini çağırarak türü yüklemeye eşdeğerdir. Derlemenin nitelenmiş adları hakkında bilgi için özelliğine Type.AssemblyQualifiedName bakın. Tür adlarını belirtme hakkında ek ayrıntılar için bkz GetType(String, Boolean, Boolean) . yöntem aşırı yüklemesi.

Derleme yürütme için zaten yüklüyse, yalnızca yansıma bağlamı içine başka bir kopya yüklenir.

throwIfNotFound parametresi, tür bulunamadığında ne olacağını belirtir ve ayrıca Özel Durumlar bölümünde açıklandığı gibi diğer bazı özel durum koşullarını bastırır. Değeri throwIfNotFoundne olursa olsun bazı özel durumlar oluşturulur. Örneğin, derleme geçerli değilse, olsa throwIfNotFoundfalsebile bir BadImageFormatException oluşturulur.

Yalnızca yansıma bağlamını kullanma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Derlemeleri Reflection-Only Bağlamı'na Yükleme.

Ayrıca bkz.

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Tam Olarak Nitelenmiş Tür Adlarını Belirtme
• Nasıl yapılır: Salt Yansıma Bağlamına Derlemeleri Yükleme