Type.GetType Yöntem

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver, bool throwOnError, bool ignoreCase);

public static Type? GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError, bool ignoreCase);

public static Type GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver, bool throwOnError, bool ignoreCase);

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool * bool -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type), throwOnError As Boolean, ignoreCase As Boolean) As Type

Parametreler

Döndürülenler

Belirtilen ada sahip tür. Tür bulunamazsa parametresi döndürülür throwOnError veya null özel durum oluşturulur belirtir. Bazı durumlarda, değerinden throwOnErrorbağımsız olarak bir özel durum oluşturulur. Özel Durumlar bölümüne bakın.

Özel durumlar

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz . Type.GetType için ek API açıklamaları.

Kaynak:

Type.cs

Kaynak:

Type.cs

Kaynak:

Type.cs

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

Döndürülenler

Geçerli Type.

Uygulamalar

Özel durumlar

Ayrıca bkz.

• TypeLoadException
• Tam Olarak Nitelenmiş Tür Adlarını Belirtme

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName);

public static Type GetType (string typeName);

public static Type? GetType (string typeName);

static member GetType : string -> Type

Public Shared Function GetType (typeName As String) As Type

Parametreler

Döndürülenler

Bulunursa belirtilen ada sahip tür; aksi takdirde , null.

Özel durumlar

Örnekler

Aşağıdaki örnek, türünü System.Int32 alır ve özelliğini System.Int32görüntülemek FullName için bu tür nesnesini kullanır.

using namespace System;

int main()
{
   try {
      // Get the type of a specified class.
      Type^ myType1 = Type::GetType( "System.Int32" );
      Console::WriteLine( "The full name is {0}.\n", myType1->FullName );
   }
   catch ( TypeLoadException^ e ) {
       Console::WriteLine("{0}: Unable to load type System.Int32",
                          e->GetType()->Name);
   }

   try {
      // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
      Type^ myType2 = Type::GetType( "NoneSuch", true );
      Console::WriteLine( "The full name is {0}.", myType2->FullName );
   }
   catch ( TypeLoadException^ e ) {
       Console::WriteLine("{0}: Unable to load type NoneSuch",
                          e->GetType()->Name);
   }

}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

using System;

class Example
{
     public static void Main()
     {
         try {
             // Get the type of a specified class.
             Type myType1 = Type.GetType("System.Int32");
             Console.WriteLine("The full name is {0}.\n", myType1.FullName);
         }
         catch (TypeLoadException e)
         {
            Console.WriteLine("{0}: Unable to load type System.Int32", e.GetType().Name);
         }

         try {
             // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Type myType2 = Type.GetType("NoneSuch", true);
             Console.WriteLine("The full name is {0}.", myType2.FullName);
         }
         catch(TypeLoadException e) {
            Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name);
         }
     }
}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

open System

try
    // Get the type of a specified class.
    let myType1 = Type.GetType "System.Int32"
    printfn $"The full name is {myType1.FullName}.\n"
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type System.Int32"

try
    // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
    let myType2 = Type.GetType("NoneSuch", true)
    printfn $"The full name is {myType2.FullName}."
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type NoneSuch"
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

Class Example
     Public Shared Sub Main()
         Try
             ' Get the type of the specified class.
             Dim myType1 As Type = Type.GetType("System.Int32")
             Console.WriteLine("The full name is {0}.", myType1.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type System.Int32",
                               e.GetType().Name)
         End Try

         Console.WriteLine()

         Try
             ' Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Dim myType2 As Type = Type.GetType("NoneSuch", True)
             Console.WriteLine("The full name is {0}.", myType2.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name)
         End Try
     End Sub
End Class
' The example displays the following output:
'       The full name is System.Int32.
'
'       TypeLoadException: Unable to load type NoneSuch

Açıklamalar

başka bir derlemedeki bir Type tür için nesnesi almak için yöntemini kullanabilirsinizGetType. Derlemenin nitelenmiş adını biliyorsanız, bu nesne öğesinden AssemblyQualifiedNameelde edilebilir. GetType içinde belirtilen derlemenin yüklenmesine typeNameneden olur. Ayrıca yöntemini kullanarak Assembly.Load bir derleme yükleyebilir ve nesneleri almak Type için veya Assembly.GetTypes yöntemini kullanabilirsinizAssembly.GetType. Bir tür derleme zamanında programınız tarafından bilinen bir derlemedeyse, C# dilinde veya GetType Visual Basic'teki işleçte kullanmak typeof daha verimlidir.

GetType yalnızca diskten yüklenen derlemelerde çalışır. Hizmetleri kullanarak System.Reflection.Emit tanımlanan dinamik derlemede tanımlanan bir türü aramak için çağırırsanız GetType tutarsız davranışlar yaşayabilirsiniz. Davranış, dinamik derlemenin kalıcı olup olmamasına, yani numaralandırmanın RunAndSave veya Save erişim modları kullanılarak oluşturulup oluşturulmadığına System.Reflection.Emit.AssemblyBuilderAccess bağlıdır. Dinamik derleme kalıcıysa ve çağrılmadan önce GetType diske yazılmışsa, yükleyici kaydedilen derlemeyi diskte bulur, bu derlemeyi yükler ve türü bu derlemeden alır. Çağrıldığında GetType derleme diske kaydedilmemişse yöntemi döndürür null. GetType geçici dinamik derlemeleri anlamaz; bu nedenle, geçici dinamik derlemedeki bir türü almak için çağrısı GetType döndürür null.

Dinamik modülde kullanmak GetType için AppDomain.AssemblyResolve olaya abone olun ve kaydetmeden önce çağrısı yapın GetType . Aksi takdirde, derlemenin iki kopyasını bellekte alırsınız.

Aşağıdaki tabloda, bir türe yansıtılırken yöntemler tarafından Get döndürülen temel sınıfın üyeleri gösterilmektedir.

1. "Ada ve imzaya göre gizle" özelliği, imzanın tüm parçalarını (özel değiştiriciler, dönüş türleri, parametre türleri, başlangıç/bitiş simgeleri ve yönetilmeyen çağrı kuralları dahil) dikkate alır. Bu ikili bir karşılaştırmadır.

2. Yansıma için, özellikler ve olaylar "ada ve imzaya göre gizle" özelliğindedir. Bu temel sınıfta hem alma hem de ayarlama erişimcisine sahip bir özelliğiniz varsa, ancak türetilen sınıfın yalnızca bir alma erişimcisi varsa, türetilen sınıf özelliği temel sınıf özelliğini gizler ve siz de temel sınıfta ayarlayıcıya erişemezsiniz.

3. Özel öznitelikler ortak tür sisteminin parçası değildir.

Diziler veya COM türleri, kullanılabilir sınıfların tablosuna yüklenmedikleri sürece aranamaz.

typeName ad alanına göre nitelenmiş tür adı veya derleme adı belirtimi içeren bir derleme nitelikli adı olabilir. Bkz. AssemblyQualifiedName.

Ad alanını içeriyorsa ancak derleme adını içermiyorsa typeName , bu yöntem yalnızca çağıran nesnenin derlemesini ve mscorlib.dll/System.Private.CoreLib.dll bu sırada arar. typeName, kısmi veya tam derleme adıyla tam nitelenmişse, bu yöntem belirtilen derlemede arar. Derlemenin tanımlayıcı bir adı varsa, tam bir derleme adı gerekir.

AssemblyQualifiedName özelliği, iç içe türler, derleme adı ve genel tür bağımsız değişkenleri de dahil olmak üzere tam tür adı döndürür. Ortak dil çalışma zamanını destekleyen tüm derleyiciler iç içe geçmiş bir sınıf yerine basit adı yayar ve yansıma, sorgulandığında aşağıdaki kurallara uygun şekilde kodlanmış bir ad oluşturur.

Örneğin, bir sınıf için tam ad aşağıdaki gibi olabilir:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Ad alanı TopNamespace.Sub+Namespace ise, dizenin iç içe ayırıcı olarak yorumlanmasını önlemek için artı işaretinden (+) önce bir kaçış karakteri (\) olması gerekir. Yansıma bu dizeyi aşağıdaki gibi yayar:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" "\+\+" olur ve "\" ise "\\" olur.

Bu nitelenmiş ad kalıcı hale gelebilir ve daha sonra yüklemek Typeiçin kullanılabilir. araması yapmak ve yüklemek Typeiçin yalnızca tür adıyla veya derlemenin tam tür adıyla kullanın GetType . GetType tür adıyla yalnızca çağıranın derlemesinde ve ardından Sistem derlemesinde öğesini arar Type . GetType derlemenin tam tür adı ile herhangi bir derlemede öğesini Type arar.

Tür adlarının sonunda, türle ilgili ek bilgileri (türün bir başvuru türü, işaretçi türü veya dizi türü olduğu) belirten karakterler bulunabilir. Bu karakterler olmadan tür adını almak için t.GetElementType().ToString()kullanın; burada t türdür.

Boşluklar, derleme adı dışındaki tüm tür adı bileşenlerinde kullanılabilir. Derleme adında, ',' ayırıcısından önceki boşluklar kabul edilir, ancak ',' ayırıcısından sonraki boşluklar gözardı edilir.

Genel bir türün adı, arkasına genel tür bağımsız değişkenlerinin sayısını gösteren basamaklar (') ile biter. Bu ad düzenlemesinin amacı, derleyicilerin aynı ada sahip ancak aynı kapsamda farklı sayıda tür parametresi bulunan genel türleri desteklemesine izin vermektir. Örneğin, yansıma, genel yöntemlerden Tuple(Of T0, T1)Tuple(Of T) ve Tuple`2 Visual Basic'te veya Tuple<T> Visual C# içinde mangled adlarını Tuple`1 ve Tuple<T0, T1> döndürür.

Genel türler için tür bağımsız değişkeni listesi köşeli ayraç içine alınır ve tür bağımsız değişkenleri virgülle ayrılır. Örneğin, bir genelin Dictionary<TKey,TValue> iki tür parametresi vardır. MyType Türünde Dictionary<TKey,TValue> anahtarlar içeren bir değeri String aşağıdaki gibi gösterilebilir:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Tür bağımsız değişken listesinde derleme nitelikli bir tür belirtmek için, derlemeye uygun türü köşeli ayraç içine alın. Aksi takdirde, derleme nitelikli adının bölümlerini ayıran virgüller, ek tür bağımsız değişkenlerini sınırlandırma olarak yorumlanır. Örneğin, Dictionary<TKey,TValue>MyType anahtar türüne Stringsahip fromMyAssembly.dll aşağıdaki gibi belirtilebilir:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

Null atanabilir türler, genel türlerin özel bir örneğidir. Örneğin, null atanabilir Int32 değeri "System.Nullable'1[System.Int32]" dizesiyle gösterilir.

Aşağıdaki tabloda, çeşitli türler için kullandığınız GetType söz dizimi gösterilmektedir.

Ayrıca bkz.

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Tam Olarak Nitelenmiş Tür Adlarını Belirtme

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, bool throwOnError);

public static Type GetType (string typeName, bool throwOnError);

public static Type? GetType (string typeName, bool throwOnError);

static member GetType : string * bool -> Type

Public Shared Function GetType (typeName As String, throwOnError As Boolean) As Type

Parametreler

Döndürülenler

Belirtilen ada sahip tür. Tür bulunamazsa, throwOnError parametresi döndürülür veya null bir özel durum oluşturulur belirtir. Bazı durumlarda, değerinden throwOnErrorbağımsız olarak bir özel durum oluşturulur. Özel Durumlar bölümüne bakın.

Özel durumlar

Örnekler

Aşağıdaki örnek, türünü System.Int32 alır ve özelliğini System.Int32görüntülemek FullName için bu tür nesnesini kullanır. Tür nesnesi var olmayan bir derlemeye başvuruyorsa, bu örnek bir özel durum oluşturur.

using namespace System;

int main()
{
   try {
      // Get the type of a specified class.
      Type^ myType1 = Type::GetType( "System.Int32" );
      Console::WriteLine( "The full name is {0}.\n", myType1->FullName );
   }
   catch ( TypeLoadException^ e ) {
       Console::WriteLine("{0}: Unable to load type System.Int32",
                          e->GetType()->Name);
   }

   try {
      // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
      Type^ myType2 = Type::GetType( "NoneSuch", true );
      Console::WriteLine( "The full name is {0}.", myType2->FullName );
   }
   catch ( TypeLoadException^ e ) {
       Console::WriteLine("{0}: Unable to load type NoneSuch",
                          e->GetType()->Name);
   }

}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

using System;

class Example
{
     public static void Main()
     {
         try {
             // Get the type of a specified class.
             Type myType1 = Type.GetType("System.Int32");
             Console.WriteLine("The full name is {0}.\n", myType1.FullName);
         }
         catch (TypeLoadException e)
         {
            Console.WriteLine("{0}: Unable to load type System.Int32", e.GetType().Name);
         }

         try {
             // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Type myType2 = Type.GetType("NoneSuch", true);
             Console.WriteLine("The full name is {0}.", myType2.FullName);
         }
         catch(TypeLoadException e) {
            Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name);
         }
     }
}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

open System

try
    // Get the type of a specified class.
    let myType1 = Type.GetType "System.Int32"
    printfn $"The full name is {myType1.FullName}.\n"
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type System.Int32"

try
    // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
    let myType2 = Type.GetType("NoneSuch", true)
    printfn $"The full name is {myType2.FullName}."
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type NoneSuch"
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

Class Example
     Public Shared Sub Main()
         Try
             ' Get the type of the specified class.
             Dim myType1 As Type = Type.GetType("System.Int32")
             Console.WriteLine("The full name is {0}.", myType1.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type System.Int32",
                               e.GetType().Name)
         End Try

         Console.WriteLine()

         Try
             ' Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Dim myType2 As Type = Type.GetType("NoneSuch", True)
             Console.WriteLine("The full name is {0}.", myType2.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name)
         End Try
     End Sub
End Class
' The example displays the following output:
'       The full name is System.Int32.
'
'       TypeLoadException: Unable to load type NoneSuch

Açıklamalar

derleme nitelikli adını AssemblyQualifiedNamebiliyorsanız, başka bir Type derlemedeki bir türün nesnesini almak için yöntemini kullanabilirsinizGetType. GetType içinde belirtilen derlemenin yüklenmesine typeNameneden olur. Ayrıca yöntemini kullanarak Assembly.Load bir derleme yükleyebilir ve nesneleri almak Type için veya Assembly.GetTypes yöntemini kullanabilirsinizAssembly.GetType. Bir tür derleme zamanında programınız tarafından bilinen bir derlemedeyse, C# dilinde veya GetType Visual Basic'teki işleçte kullanmak typeof daha verimlidir.

GetType yalnızca diskten yüklenen derlemelerde çalışır. Hizmetleri kullanarak System.Reflection.Emit tanımlanan dinamik derlemede tanımlanan bir türü aramak için çağırırsanız GetType tutarsız davranışlar alabilirsiniz. Davranış, dinamik derlemenin kalıcı olup olmadığına, yani numaralandırmanın RunAndSave veya Save erişim modları System.Reflection.Emit.AssemblyBuilderAccess kullanılarak oluşturulup oluşturulmadığına bağlıdır. Dinamik derleme kalıcıysa ve çağrılmadan önce GetType diske yazıldıysa, yükleyici diskte kayıtlı derlemeyi bulur, bu derlemeyi yükler ve türü bu derlemeden alır. Çağrıldığında derleme diske kaydedilmemişse GetType , yöntemi döndürür null. GetType geçici dinamik derlemeleri anlamaz; bu nedenle, geçici dinamik derlemedeki bir türü almak için çağrısı GetType döndürür null.

Dinamik modülde kullanmak GetType için AppDomain.AssemblyResolve olaya abone olun ve kaydetmeden önce çağrısı GetType yapın. Aksi takdirde, derlemenin bellekte iki kopyasını alırsınız.

throwOnError 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 throwOnErrorne olursa olsun bazı özel durumlar oluşturulur. Örneğin, tür bulunur ancak yüklenemezse, olsa throwOnErrorfalsebile bir TypeLoadException oluşturulur.

Aşağıdaki tabloda, bir türe yansıtılırken yöntemler tarafından döndürülen temel sınıfın Get üyeleri gösterilmektedir.

1. "Ada ve imzaya göre gizle" özelliği, imzanın tüm parçalarını (özel değiştiriciler, dönüş türleri, parametre türleri, başlangıç/bitiş simgeleri ve yönetilmeyen çağrı kuralları dahil) dikkate alır. Bu ikili bir karşılaştırmadır.

2. Yansıma için, özellikler ve olaylar "ada ve imzaya göre gizle" özelliğindedir. Bu temel sınıfta hem alma hem de ayarlama erişimcisine sahip bir özelliğiniz varsa, ancak türetilen sınıfın yalnızca bir alma erişimcisi varsa, türetilen sınıf özelliği temel sınıf özelliğini gizler ve siz de temel sınıfta ayarlayıcıya erişemezsiniz.

3. Özel öznitelikler ortak tür sisteminin parçası değildir.

Diziler veya COM türleri, kullanılabilir sınıflar tablosuna önceden yüklenmedikleri sürece aranmıyor.

typeName , ad alanı tarafından nitelenmiş tür adı veya derleme adı belirtimi içeren bir derleme nitelikli adı olabilir. Bkz. AssemblyQualifiedName.

Ad alanını içeriyorsa ancak derleme adını içermiyorsa typeName , bu yöntem yalnızca çağıran nesnenin derlemesini arar ve /System.Private.CoreLib.dll mscorlib.dll. typeName, kısmi veya tam derleme adıyla tam olarak nitelenmişse, bu yöntem belirtilen derlemede arar. Derlemenin tanımlayıcı bir adı varsa, tam bir derleme adı gerekir.

AssemblyQualifiedName özelliği iç içe türler, derleme adı ve genel bağımsız değişkenler de dahil olmak üzere tam tür adını döndürür. Ortak dil çalışma zamanını destekleyen tüm derleyiciler iç içe geçmiş bir sınıf yerine basit adı yayar ve yansıma, sorgulandığında aşağıdaki kurallara uygun şekilde kodlanmış bir ad oluşturur.

Örneğin, bir sınıf için tam ad aşağıdaki gibi olabilir:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Ad alanı TopNamespace.Sub+Namespace ise, dizenin iç içe ayırıcı olarak yorumlanmasını önlemek için artı işaretinden (+) önce bir kaçış karakteri (\) olması gerekir. Yansıma bu dizeyi aşağıdaki gibi yayar:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" "\+\+" olur ve "\" "\\" olur.

Bu nitelenmiş ad kalıcı hale gelebilir ve daha sonra yüklemek Typeiçin kullanılabilir. araması yapmak ve yüklemek Typeiçin yalnızca tür adıyla veya derlemenin tam tür adıyla kullanın GetType . GetType tür adıyla yalnızca çağıranın derlemesinde ve ardından Sistem derlemesinde öğesini arar Type . GetType derleme nitelikli tür adı ile herhangi bir derlemede öğesini Type arar.

Tür adlarının sonunda, türle ilgili ek bilgileri (türün bir başvuru türü, işaretçi türü veya dizi türü olduğu) belirten karakterler bulunabilir. Bu karakterler olmadan tür adını almak için t.GetElementType().ToString()kullanın; burada t türdür.

Boşluklar, derleme adı dışındaki tüm tür adı bileşenlerinde kullanılabilir. Derleme adında, ',' ayırıcısından önceki boşluklar kabul edilir, ancak ',' ayırıcısından sonraki boşluklar gözardı edilir.

Genel bir türün adı bir ters köşe (') ile biter ve ardından genel tür bağımsız değişkenlerinin sayısını temsil eden basamaklar eklenir. Bu ad düzenlemesinin amacı, derleyicilerin aynı ada sahip ancak aynı kapsamda farklı sayıda tür parametresi bulunan genel türleri desteklemesine izin vermektir. Örneğin, yansıma, genel yöntemlerden ve Visual Basic'te veya Tuple<T> Visual C# içinde mangled adlarını Tuple`1 döndürürTuple<T0, T1>.Tuple`2Tuple(Of T)Tuple(Of T0, T1)

Genel türler için, tür bağımsız değişkeni listesi köşeli ayraç içine alınır ve tür bağımsız değişkenleri virgülle ayrılır. Örneğin, bir genel Dictionary<TKey,TValue> iki tür parametreye sahiptir. Dictionary<TKey,TValue> MyType Anahtar türüne String sahip bir değeri aşağıdaki gibi gösterilebilir:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Tür bağımsız değişken listesinde derleme nitelikli bir tür belirtmek için, derleme nitelikli türü köşeli ayraç içine alın. Aksi takdirde, derleme nitelikli adının bölümlerini ayıran virgüller, ek tür bağımsız değişkenlerini sınırlandırma olarak yorumlanır. Örneğin, türündeki anahtarlara Stringsahip MyAssembly.dll'den biri Dictionary<TKey,TValue>MyType aşağıdaki gibi belirtilebilir:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

Null atanabilir türler, genel türlerin özel bir örneğidir. Örneğin, null atanabilir Int32 değeri "System.Nullable'1[System.Int32]" dizesiyle temsil edilir.

Aşağıdaki tabloda, çeşitli türler için kullandığınız GetType söz dizimi gösterilmektedir.

Ayrıca bkz.

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Tam Olarak Nitelenmiş Tür Adlarını Belirtme

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, bool throwOnError, bool ignoreCase);

public static Type GetType (string typeName, bool throwOnError, bool ignoreCase);

public static Type? GetType (string typeName, bool throwOnError, bool ignoreCase);

static member GetType : string * bool * bool -> Type

Public Shared Function GetType (typeName As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parametreler

Döndürülenler

Belirtilen ada sahip tür. Tür bulunamazsa, throwOnError parametresi döndürülür veya null bir özel durum oluşturulur belirtir. Bazı durumlarda, değerinden throwOnErrorbağımsız olarak bir özel durum oluşturulur. Özel Durumlar bölümüne bakın.

Özel durumlar

Açıklamalar

başka bir derlemedeki bir Type tür için nesnesi almak için yöntemini kullanabilirsinizGetType. Derlemenin nitelenmiş adını biliyorsanız, bu nesne öğesinden AssemblyQualifiedNameelde edilebilir. GetType içinde belirtilen derlemenin yüklenmesine typeNameneden olur. Ayrıca yöntemini kullanarak Assembly.Load bir derleme yükleyebilir ve nesneleri almak Type için veya Assembly.GetTypes yöntemini kullanabilirsinizAssembly.GetType. Bir tür derleme zamanında programınız tarafından bilinen bir derlemedeyse, C# dilinde veya GetType Visual Basic'teki işleçte kullanmak typeof daha verimlidir.

GetType yalnızca diskten yüklenen derlemelerde çalışır. Hizmetleri kullanarak System.Reflection.Emit tanımlanan dinamik derlemede tanımlanan bir türü aramak için çağırırsanız GetType tutarsız davranışlar yaşayabilirsiniz. Davranış, dinamik derlemenin kalıcı olup olmamasına, yani numaralandırmanın RunAndSave veya Save erişim modları kullanılarak oluşturulup oluşturulmadığına System.Reflection.Emit.AssemblyBuilderAccess bağlıdır. Dinamik derleme kalıcıysa ve çağrılmadan önce GetType diske yazılmışsa, yükleyici kaydedilen derlemeyi diskte bulur, bu derlemeyi yükler ve türü bu derlemeden alır. Çağrıldığında GetType derleme diske kaydedilmemişse yöntemi döndürür null. GetType geçici dinamik derlemeleri anlamaz; bu nedenle, geçici dinamik derlemedeki bir türü almak için çağrısı GetType döndürür null.

Dinamik modülde kullanmak GetType için AppDomain.AssemblyResolve olaya abone olun ve kaydetmeden önce çağrısı yapın GetType . Aksi takdirde, derlemenin iki kopyasını bellekte alırsınız.

throwOnError 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. değerinden throwOnErrorbağımsız olarak bazı özel durumlar oluşturulur. Örneğin, tür bulunur ancak yüklenemezse, olsa throwOnErrorfalsebile bir TypeLoadException oluşturulur.

Aşağıdaki tabloda, bir türe yansıtılırken yöntemler tarafından Get döndürülen temel sınıfın üyeleri gösterilmektedir.

1. "Ada ve imzaya göre gizle" özelliği, imzanın tüm parçalarını (özel değiştiriciler, dönüş türleri, parametre türleri, başlangıç/bitiş simgeleri ve yönetilmeyen çağrı kuralları dahil) dikkate alır. Bu ikili bir karşılaştırmadır.

2. Yansıma için, özellikler ve olaylar "ada ve imzaya göre gizle" özelliğindedir. Bu temel sınıfta hem alma hem de ayarlama erişimcisine sahip bir özelliğiniz varsa, ancak türetilen sınıfın yalnızca bir alma erişimcisi varsa, türetilen sınıf özelliği temel sınıf özelliğini gizler ve siz de temel sınıfta ayarlayıcıya erişemezsiniz.

3. Özel öznitelikler ortak tür sisteminin parçası değildir.

Diziler veya COM türleri, kullanılabilir sınıfların tablosuna yüklenmedikleri sürece aranamaz.

typeName ad alanına göre nitelenmiş tür adı veya derleme adı belirtimi içeren bir derleme nitelikli adı olabilir. Bkz. AssemblyQualifiedName.

Ad alanını içeriyorsa ancak derleme adını içermiyorsa typeName , bu yöntem yalnızca çağıran nesnenin derlemesini ve mscorlib.dll/System.Private.CoreLib.dll bu sırada arar. typeName, kısmi veya tam derleme adıyla tam nitelenmişse, bu yöntem belirtilen derlemede arar. Derlemenin tanımlayıcı bir adı varsa, tam bir derleme adı gerekir.

AssemblyQualifiedName özelliği iç içe türler, derleme adı ve tür bağımsız değişkenleri de dahil olmak üzere tam tür adı döndürür. Ortak dil çalışma zamanını destekleyen tüm derleyiciler iç içe geçmiş bir sınıf yerine basit adı yayar ve yansıma, sorgulandığında aşağıdaki kurallara uygun şekilde kodlanmış bir ad oluşturur.

Örneğin, bir sınıf için tam ad aşağıdaki gibi olabilir:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Ad alanı TopNamespace.Sub+Namespace ise, dizenin iç içe ayırıcı olarak yorumlanmasını önlemek için artı işaretinden (+) önce bir kaçış karakteri (\) olması gerekir. Yansıma bu dizeyi aşağıdaki gibi yayar:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" "\+\+" olur ve "\" ise "\\" olur.

Bu nitelenmiş ad kalıcı hale gelebilir ve daha sonra yüklemek Typeiçin kullanılabilir. araması yapmak ve yüklemek Typeiçin yalnızca tür adıyla veya derlemenin tam tür adıyla kullanın GetType . GetType tür adıyla yalnızca çağıranın derlemesinde ve ardından Sistem derlemesinde öğesini arar Type . GetType derlemenin tam tür adı ile herhangi bir derlemede öğesini Type arar.

Tür adlarının sonunda, türle ilgili ek bilgileri (türün bir başvuru türü, işaretçi türü veya dizi türü olduğu) belirten karakterler bulunabilir. Bu karakterler olmadan tür adını almak için t.GetElementType().ToString()kullanın; burada t türdür.

Boşluklar, derleme adı dışındaki tüm tür adı bileşenlerinde kullanılabilir. Derleme adında, ',' ayırıcısından önceki boşluklar kabul edilir, ancak ',' ayırıcısından sonraki boşluklar gözardı edilir.

Genel bir türün adı bir ters köşe (') ile biter ve ardından genel tür bağımsız değişkenlerinin sayısını temsil eden basamaklar eklenir. Bu ad düzenlemesinin amacı, derleyicilerin aynı ada sahip ancak aynı kapsamda farklı sayıda tür parametresi bulunan genel türleri desteklemesine izin vermektir. Örneğin, yansıma, genel yöntemlerden ve Visual Basic'te veya Tuple<T> Visual C# içinde mangled adlarını Tuple`1 döndürürTuple<T0, T1>.Tuple`2Tuple(Of T)Tuple(Of T0, T1)

Genel türler için, tür bağımsız değişkeni listesi köşeli ayraç içine alınır ve tür bağımsız değişkenleri virgülle ayrılır. Örneğin, bir genel Dictionary<TKey,TValue> iki tür parametreye sahiptir. Dictionary<TKey,TValue> MyType Anahtar türüne String sahip bir değeri aşağıdaki gibi gösterilebilir:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Tür bağımsız değişken listesinde derleme nitelikli bir tür belirtmek için, derleme nitelikli türü köşeli ayraç içine alın. Aksi takdirde, derleme nitelikli adının bölümlerini ayıran virgüller, ek tür bağımsız değişkenlerini sınırlandırma olarak yorumlanır. Örneğin, türündeki anahtarlara Stringsahip MyAssembly.dll'den biri Dictionary<TKey,TValue>MyType aşağıdaki gibi belirtilebilir:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

Null atanabilir türler, genel türlerin özel bir örneğidir. Örneğin, null atanabilir Int32 değeri "System.Nullable'1[System.Int32]" dizesiyle temsil edilir.

Aşağıdaki tabloda, çeşitli türler için kullandığınız GetType söz dizimi gösterilmektedir.

Ayrıca bkz.

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Tam Olarak Nitelenmiş Tür Adlarını Belirtme

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver);

public static Type? GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver);

public static Type GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver);

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type)) As Type

Parametreler

Döndürülenler

Belirtilen ada sahip tür veya null tür bulunamaz.

Özel durumlar

Açıklamalar

Bu yöntem için kullanım senaryoları ve ve typeResolver parametreleriyle ilgili assemblyResolver ayrıntılar yöntem aşırı yüklemesinde GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) bulunabilir.

Bu yöntem aşırı yüklemesini çağırmak, yöntem aşırı yüklemesini GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) çağırmak ve ve ignoreCase parametreleri için belirtmekle falsethrowOnError aynıdır.

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

Kaynak:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver, bool throwOnError);

public static Type? GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError);

public static Type GetType (string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver, bool throwOnError);

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type), throwOnError As Boolean) As Type

Parametreler

Döndürülenler

Belirtilen ada sahip tür. Tür bulunamazsa, throwOnError parametresi döndürülür veya null bir özel durum oluşturulur belirtir. Bazı durumlarda, değerinden throwOnErrorbağımsız olarak bir özel durum oluşturulur. Özel Durumlar bölümüne bakın.

Özel durumlar

Açıklamalar

Bu yöntem için kullanım senaryoları ve ve typeResolver parametreleriyle ilgili assemblyResolver ayrıntılar yöntem aşırı yüklemesinde GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) bulunabilir.

Bu yöntem aşırı yüklemesini çağırmak, yöntem aşırı yüklemesini GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) çağırmak ve parametresini belirtmekle falseignoreCase aynıdır.