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

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Type.cs

Dikkat

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Type Büyük/küçük harfe duyarlı 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 öğesinin Type derleme nitelikli adı.

throwIfNotFound

Boolean

true TypeLoadException türü bulunamazsa oluşturmak; false türü bulunamazsa döndürmek null için. Belirtme, false diğer bazı özel durum koşullarını da gizler, ancak tümünü gizlemez. Ö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 yapmak 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'e eşittir.

TargetInvocationException

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

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 typeName ve true 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 is true ve typeName geçersiz söz dizimi içeriyor; örneğin, "MyType[,*,]".

-veya-

typeName, işaretçi türüne, türüne veya Void tür bağımsız değişkenlerinden biri olarak sahip 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 veya 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 önce yalnızca yansıma için derlemenin yüklenmesine, yöntemin kullanılmasına ve ardından derlemenin ReflectionOnlyLoadAssembly.GetType yöntemini çağırarak türün yüklenmesine 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 yöntem aşırı yüklemesine GetType(String, Boolean, Boolean) bakın.

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 özel durumlar bölümünde açıklandığı gibi diğer bazı özel durum koşullarını gizler. bazı özel durumlar değeri throwIfNotFoundne olursa olsun 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 Tür Adlarını Belirtme
• Nasıl yapılır: Derlemeleri Reflection-Only Bağlamı'na Yükleme