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

Tanım

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);
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}")]
public static Type? ReflectionOnlyGetType (string typeName, bool throwIfNotFound, bool ignoreCase);
public static Type ReflectionOnlyGetType (string typeName, bool throwIfNotFound, bool ignoreCase);
static member ReflectionOnlyGetType : string * bool * bool -> Type
[<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

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

Özel durumlar

typeName, null değeridir.

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

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.

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.

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

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

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

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.

Şunlara uygulanır

Ayrıca bkz.