Assembly.GetType Metoda

Definicja

Przestrzeń nazw:

System.Reflection

Zestaw:

System.Runtime.dll

Type Pobiera obiekt reprezentujący określony typ.

Przeciążenia

GetType(String, Boolean, Boolean)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu, z opcjami ignorowania przypadku i zgłaszania wyjątku, jeśli typ nie zostanie znaleziony.
GetType(String, Boolean)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu i opcjonalnie zgłasza wyjątek, jeśli typ nie zostanie znaleziony.
GetType(String)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu.

GetType(String, Boolean, Boolean)

Źródło:

Assembly.cs

Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu, z opcjami ignorowania przypadku i zgłaszania wyjątku, jeśli typ nie zostanie znaleziony.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError, bool ignoreCase);

public virtual Type? GetType (string name, bool throwOnError, bool ignoreCase);

override this.GetType : string * bool * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parametry

name

String

Pełna nazwa typu.

throwOnError

Boolean

true zgłosić wyjątek, jeśli typ nie zostanie znaleziony; false , aby zwrócić wartość null.

ignoreCase

Boolean

true ignorować wielkość liter nazwy typu; w przeciwnym razie , false.

Zwraca

Type

Obiekt reprezentujący określoną klasę.

Wyjątki

ArgumentException

Nazwa name jest niepoprawna.

-lub-

Długość name przekracza 1024 znaków.

ArgumentNullException

name to null.

TypeLoadException

throwOnError to true, a nie można odnaleźć typu .

FileNotFoundException

name wymaga zestawu zależnego, którego nie można odnaleźć.

FileLoadException

name wymaga zestawu zależnego, który został znaleziony, ale nie można go załadować.

-lub-

Bieżący zestaw został załadowany do kontekstu tylko odbicia i name wymaga zależnego zestawu, który nie został wstępnie załadowany.

BadImageFormatException

typeName wymaga zestawu zależnego, ale plik nie jest prawidłowym zestawem dla aktualnie załadowanego środowiska uruchomieniowego.

Uwagi

Ta metoda wyszukuje tylko bieżące wystąpienie zestawu. Parametr name zawiera przestrzeń nazw, ale nie zestaw. Aby wyszukać inne zestawy dla typu, użyj Type.GetType(String) przeciążenia metody, które opcjonalnie może zawierać nazwę wyświetlaną zestawu jako część nazwy typu.

Uwaga

Jeśli typ został przekazany do innego zestawu, nadal jest zwracany przez tę metodę. Aby uzyskać informacje na temat przekazywania typów, zobacz Przekazywanie typów w środowisku uruchomieniowym języka wspólnego.

Parametr throwOnError wpływa tylko na to, co się stanie, gdy typ nie zostanie znaleziony. Nie ma to wpływu na inne wyjątki, które mogą zostać zgłoszone. W szczególności, jeśli typ zostanie znaleziony, ale nie można go załadować, można zgłosić, TypeLoadException nawet jeśli throwOnError ma wartość false.

GetType(String, Boolean)

Źródło:

Assembly.cs

Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu i opcjonalnie zgłasza wyjątek, jeśli typ nie zostanie znaleziony.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError);

public virtual Type? GetType (string name, bool throwOnError);

override this.GetType : string * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean) As Type

Parametry

name

String

Pełna nazwa typu.

throwOnError

Boolean

true zgłosić wyjątek, jeśli typ nie zostanie znaleziony; false , aby zwrócić wartość null.

Zwraca

Type

Obiekt reprezentujący określoną klasę.

Wyjątki

ArgumentException

Nazwa name jest niepoprawna.

-lub-

Długość name przekracza 1024 znaków.

ArgumentNullException

name to null.

TypeLoadException

throwOnError to true, a nie można odnaleźć typu .

FileNotFoundException

name wymaga zestawu zależnego, którego nie można odnaleźć.

FileLoadException

name wymaga zestawu zależnego, który został znaleziony, ale nie można go załadować.

-lub-

Bieżący zestaw został załadowany do kontekstu tylko odbicia i name wymaga zależnego zestawu, który nie został wstępnie załadowany.

BadImageFormatException

typeName wymaga zestawu zależnego, ale plik nie jest prawidłowym zestawem dla aktualnie załadowanego środowiska uruchomieniowego.

Uwagi

Ta metoda wyszukuje tylko bieżące wystąpienie zestawu. Parametr name zawiera przestrzeń nazw, ale nie zestaw. Aby wyszukać inne zestawy dla typu, użyj Type.GetType(String) przeciążenia metody, które opcjonalnie może zawierać nazwę wyświetlaną zestawu jako część nazwy typu.

Uwaga

Jeśli typ został przekazany do innego zestawu, nadal jest zwracany przez tę metodę. Aby uzyskać informacje na temat przekazywania typów, zobacz Przekazywanie typów w środowisku uruchomieniowym języka wspólnego.

Parametr throwOnError wpływa tylko na to, co się stanie, gdy typ nie zostanie znaleziony. Nie ma to wpływu na inne wyjątki, które mogą zostać zgłoszone. W szczególności, jeśli typ zostanie znaleziony, ale nie można go załadować, można zgłosić, TypeLoadException nawet jeśli throwOnError ma wartość false.

GetType(String)

Źródło:

Assembly.cs

Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu.

public:
 virtual Type ^ GetType(System::String ^ name);

public virtual Type? GetType (string name);

override this.GetType : string -> Type

Public Overridable Function GetType (name As String) As Type

Parametry

name

String

Pełna nazwa typu.

Zwraca

Type

Obiekt reprezentujący określoną klasę lub null jeśli klasa nie zostanie znaleziona.

Wyjątki

ArgumentException

Nazwa name jest niepoprawna.

ArgumentNullException

name to null.

FileNotFoundException

name wymaga zestawu zależnego, którego nie można odnaleźć.

FileLoadException

name wymaga zestawu zależnego, który został znaleziony, ale nie można go załadować.

-lub-

Bieżący zestaw został załadowany do kontekstu tylko odbicia i name wymaga zależnego zestawu, który nie został wstępnie załadowany.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub biblioteki klas przenośnych przechwyć wyjątek klasy bazowej , IOExceptionzamiast tego.

BadImageFormatException

typeName wymaga zestawu zależnego, ale plik nie jest prawidłowym zestawem dla aktualnie załadowanego środowiska uruchomieniowego.

Przykłady

W poniższym przykładzie zdefiniowano abstrakcyjną MeansOfTransportation klasę Transportation w przestrzeni nazw. Wywołuje metodę GetType(String) , aby pobrać jej Type obiekt, wywołuje Type.GetProperties metodę , aby uzyskać tablicę PropertyInfo obiektów reprezentujących właściwości typu, a następnie wyświetla informacje o właściwościach abstrakcyjnych typu. Należy pamiętać GetType(String) , że wywołanie metody używa w pełni kwalifikowanej nazwy typu (czyli jej przestrzeni nazw wraz z nazwą typu).

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;
        Type t = assem.GetType("Transportation.MeansOfTransportation");
        if (t != null)
        {
            Console.WriteLine($"Virtual properties in type {t.FullName}:");
            PropertyInfo[] props = t.GetProperties();
            int nVirtual = 0;
            for (int ctr = 0; ctr < props.Length; ctr++)
            {
                if (props[ctr].GetMethod.IsVirtual)
                {
                    Console.WriteLine($"   {props[ctr].Name} (type {props[ctr].PropertyType.FullName})");
                    nVirtual++;
                }
            }

            if (nVirtual == 0)
                Console.WriteLine("   No virtual properties");
        }
    }
}

namespace Transportation
{
    public abstract class MeansOfTransportation
    {
        abstract public bool HasWheels { get; set; }
        abstract public int Wheels { get; set; }
        abstract public bool ConsumesFuel { get; set; }
        abstract public bool Living { get; set; }
    }
}
// The example displays the following output:
//    Virtual properties in type Transportation.MeansOfTransportation:
//       HasWheels (type System.Boolean)
//       Wheels (type System.Int32)
//       ConsumesFuel (type System.Boolean)
//       Living (type System.Boolean)

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Example).Assembly
      Dim t As Type = assem.GetType("Transportation.MeansOfTransportation")
      If Not t Is Nothing Then
         Console.WriteLine("Virtual properties in type {0}:", 
                           t.FullName)
         Dim props() As PropertyInfo = t.GetProperties()
         Dim nVirtual As Integer = 0
         For ctr As Integer = 0 To props.Length - 1
            If props(ctr).GetMethod.IsVirtual Then
               Console.WriteLine("   {0} (type {1})",
                                 props(ctr).Name, 
                                 props(ctr).PropertyType.FullName)
               nVirtual += 1
            End If
         Next
         If nVirtual = 0 Then 
            Console.WriteLine("   No virtual properties")
         End If   
      End If   
   End Sub
End Module

Namespace Transportation
   Public MustInherit Class MeansOfTransportation
      Public MustOverride Property HasWheels As Boolean
      Public MustOverride Property Wheels As Integer
      Public MustOverride Property ConsumesFuel As Boolean
      Public MustOverride Property Living As Boolean
   End Class
End Namespace
' The example displays the following output:
'    Virtual properties in type Transportation.MeansOfTransportation:
'       HasWheels (type System.Boolean)
'       Wheels (type System.Int32)
'       ConsumesFuel (type System.Boolean)
'       Living (type System.Boolean)

Uwagi

Ta metoda wyszukuje tylko bieżące wystąpienie zestawu. Parametr name zawiera przestrzeń nazw, ale nie zestaw. Aby wyszukać inne zestawy dla typu, użyj Type.GetType(String) przeciążenia metody, które opcjonalnie może zawierać nazwę wyświetlaną zestawu jako część nazwy typu.

Uwaga

Jeśli typ został przekazany do innego zestawu, nadal jest zwracany przez tę metodę. Aby uzyskać informacje na temat przekazywania typów, zobacz Przekazywanie typów w środowisku uruchomieniowym języka wspólnego.