Assembly.GetType Assembly.GetType Assembly.GetType Assembly.GetType Method

Definition

Ruft das Type-Objekt ab, das den angegebenen Typ darstellt.Gets the Type object that represents the specified type.

Überlädt

GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean)

Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab, wobei optional die Groß- und Kleinschreibung unberücksichtigt bleiben und optional eine Ausnahme ausgelöst werden kann, wenn der Typ nicht gefunden wurde.Gets the Type object with the specified name in the assembly instance, with the options of ignoring the case, and of throwing an exception if the type is not found.

GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean)

Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab und löst optional eine Ausnahme aus, wenn der Typ nicht gefunden wurde.Gets the Type object with the specified name in the assembly instance and optionally throws an exception if the type is not found.

GetType(String) GetType(String) GetType(String) GetType(String)

Ruft das Type-Objekt mit dem angegebenen Namen aus der Assemblyinstanz ab.Gets the Type object with the specified name in the assembly instance.

GetType() GetType() GetType() GetType()

GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean)

Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab, wobei optional die Groß- und Kleinschreibung unberücksichtigt bleiben und optional eine Ausnahme ausgelöst werden kann, wenn der Typ nicht gefunden wurde.Gets the Type object with the specified name in the assembly instance, with the options of ignoring the case, and of throwing an exception if the type is not found.

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

Parameter

name
String String String String

Der vollständige Name des Typs.The full name of the type.

throwOnError
Boolean Boolean Boolean Boolean

true, damit eine Ausnahme ausgelöst wird, wenn der Typ nicht gefunden wurde. false, damit null zurückgegeben wird.true to throw an exception if the type is not found; false to return null.

ignoreCase
Boolean Boolean Boolean Boolean

true, um die Groß- und Kleinschreibung des Typnamens zu ignorieren, andernfalls false.true to ignore the case of the type name; otherwise, false.

Gibt zurück

Ein Objekt, das die angegebene Klasse darstellt.An object that represents the specified class.

Implementiert

Ausnahmen

name ist ungültig.name is invalid.

- oder --or- Die Länge von name überschreitet 1024 Zeichen.The length of name exceeds 1024 characters.

throwOnError ist true, und der Typ wurde nicht gefunden.throwOnError is true, and the type cannot be found.

name erfordert eine abhängige Assembly, die nicht gefunden wurde.name requires a dependent assembly that could not be found.

name erfordert eine abhängige Assembly, die gefunden wurde, aber nicht geladen werden konnte.name requires a dependent assembly that was found but could not be loaded.

- oder --or- Die aktuelle Assembly wurde in den reflektionsbezogenen Kontext geladen, und name erfordert eine abhängige Assembly, die nicht vorab geladen wurde.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name erfordert eine abhängige Assembly, die Datei ist jedoch keine gültige Assembly.name requires a dependent assembly, but the file is not a valid assembly.

- oder --or- name erfordert eine abhängige Assembly, die für eine Version der Laufzeit kompiliert wurde, die höher als die derzeit geladene Version ist.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Hinweise

Diese Methode durchsucht nur die aktuelle Assemblyinstanz.This method only searches the current assembly instance. Der name -Parameter enthält den-Namespace, jedoch nicht die Assembly.The name parameter includes the namespace but not the assembly. Wenn Sie andere Assemblys nach einem Typ durch Type.GetType(String) suchen möchten, verwenden Sie die-Methoden Überladung, die optional einen Assemblyanzeigenamen als Teil des Typnamens einschließen kann.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Hinweis

Wenn der Typ an eine andere Assembly weitergeleitet wurde, wird er weiterhin von dieser Methode zurückgegeben.If the type has been forwarded to another assembly, it is still returned by this method. Informationen zur Typweiterleitung finden Sie unter Typweiterleitung in der Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Der throwOnError -Parameter wirkt sich nur darauf aus, was geschieht, wenn der Typ nicht gefunden wird.The throwOnError parameter only affects what happens when the type is not found. Es wirkt sich nicht auf andere Ausnahmen aus, die möglicherweise ausgelöst werden.It does not affect any other exceptions that might be thrown. Insbesondere, wenn der Typ gefunden wurde, aber nicht geladen werden kann TypeLoadException , kann auch dann ausgelöst throwOnError werden false, wenn den Wert hat.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean)

Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab und löst optional eine Ausnahme aus, wenn der Typ nicht gefunden wurde.Gets the Type object with the specified name in the assembly instance and optionally throws an exception if the type is not found.

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

Parameter

name
String String String String

Der vollständige Name des Typs.The full name of the type.

throwOnError
Boolean Boolean Boolean Boolean

true, damit eine Ausnahme ausgelöst wird, wenn der Typ nicht gefunden wurde. false, damit null zurückgegeben wird.true to throw an exception if the type is not found; false to return null.

Gibt zurück

Ein Objekt, das die angegebene Klasse darstellt.An object that represents the specified class.

Implementiert

Ausnahmen

name ist ungültig.name is invalid.

- oder --or- Die Länge von name überschreitet 1024 Zeichen.The length of name exceeds 1024 characters.

throwOnError ist true, und der Typ wurde nicht gefunden.throwOnError is true, and the type cannot be found.

name erfordert eine abhängige Assembly, die nicht gefunden wurde.name requires a dependent assembly that could not be found.

name erfordert eine abhängige Assembly, die gefunden wurde, aber nicht geladen werden konnte.name requires a dependent assembly that was found but could not be loaded.

- oder --or- Die aktuelle Assembly wurde in den reflektionsbezogenen Kontext geladen, und name erfordert eine abhängige Assembly, die nicht vorab geladen wurde.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name erfordert eine abhängige Assembly, die Datei ist jedoch keine gültige Assembly.name requires a dependent assembly, but the file is not a valid assembly.

- oder --or- name erfordert eine abhängige Assembly, die für eine Version der Laufzeit kompiliert wurde, die höher als die derzeit geladene Version ist.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Hinweise

Diese Methode durchsucht nur die aktuelle Assemblyinstanz.This method only searches the current assembly instance. Der name -Parameter enthält den-Namespace, jedoch nicht die Assembly.The name parameter includes the namespace but not the assembly. Wenn Sie andere Assemblys nach einem Typ durch Type.GetType(String) suchen möchten, verwenden Sie die-Methoden Überladung, die optional einen Assemblyanzeigenamen als Teil des Typnamens einschließen kann.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Hinweis

Wenn der Typ an eine andere Assembly weitergeleitet wurde, wird er weiterhin von dieser Methode zurückgegeben.If the type has been forwarded to another assembly, it is still returned by this method. Informationen zur Typweiterleitung finden Sie unter Typweiterleitung in der Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Der throwOnError -Parameter wirkt sich nur darauf aus, was geschieht, wenn der Typ nicht gefunden wird.The throwOnError parameter only affects what happens when the type is not found. Es wirkt sich nicht auf andere Ausnahmen aus, die möglicherweise ausgelöst werden.It does not affect any other exceptions that might be thrown. Insbesondere, wenn der Typ gefunden wurde, aber nicht geladen werden kann TypeLoadException , kann auch dann ausgelöst throwOnError werden false, wenn den Wert hat.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

GetType(String) GetType(String) GetType(String) GetType(String)

Ruft das Type-Objekt mit dem angegebenen Namen aus der Assemblyinstanz ab.Gets the Type object with the specified name in the assembly instance.

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

Parameter

name
String String String String

Der vollständige Name des Typs.The full name of the type.

Gibt zurück

Ein Objekt, das die angegebene Klasse darstellt, oder null, wenn die Klasse nicht gefunden wird.An object that represents the specified class, or null if the class is not found.

Implementiert

Ausnahmen

name erfordert eine abhängige Assembly, die nicht gefunden wurde.name requires a dependent assembly that could not be found.


Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme IOException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

name erfordert eine abhängige Assembly, die gefunden wurde, jedoch nicht geladen werden konnte. name requires a dependent assembly that was found but could not be loaded.

- oder --or- Die aktuelle Assembly wurde in den reflektionsbezogenen Kontext geladen, und name erfordert eine abhängige Assembly, die nicht vorab geladen wurde.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name erfordert eine abhängige Assembly, die Datei ist jedoch keine gültige Assembly.name requires a dependent assembly, but the file is not a valid assembly.

- oder --or- name erfordert eine abhängige Assembly, die für eine Version der Laufzeit kompiliert wurde, die höher als die derzeit geladene Version ist.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Beispiele

Im folgenden Beispiel wird eine abstrakte MeansOfTransportation Klasse Transportation im-Namespace definiert.The following example defines an abstract MeansOfTransportation class in the Transportation namespace. Sie ruft die GetType(String) -Methode auf, Type um das Objekt abzurufen Type.GetProperties , ruft die-Methode auf PropertyInfo , um ein Array von-Objekten abzurufen, die die Eigenschaften des Typs darstellen, und zeigt dann Informationen zu den abstrakten Eigenschaften des Typs an.It calls the GetType(String) method to retrieve its Type object, calls the Type.GetProperties method to get an array of PropertyInfo objects that represent the type's properties, and then displays information on the type's abstract properties. Beachten Sie, dass der GetType(String) Methodenaufrufe den voll qualifizierten Namen des Typs verwendet (d. h. seinen Namespace zusammen mit dem Typnamen).Note that the call to the GetType(String) method uses the type's fully qualified name (that is, its namespace along with its type name).

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)

Hinweise

Diese Methode durchsucht nur die aktuelle Assemblyinstanz.This method only searches the current assembly instance. Der name -Parameter enthält den-Namespace, jedoch nicht die Assembly.The name parameter includes the namespace but not the assembly. Wenn Sie andere Assemblys nach einem Typ durch Type.GetType(String) suchen möchten, verwenden Sie die-Methoden Überladung, die optional einen Assemblyanzeigenamen als Teil des Typnamens einschließen kann.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Hinweis

Wenn der Typ an eine andere Assembly weitergeleitet wurde, wird er weiterhin von dieser Methode zurückgegeben.If the type has been forwarded to another assembly, it is still returned by this method. Informationen zur Typweiterleitung finden Sie unter Typweiterleitung in der Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

GetType() GetType() GetType() GetType()

public:
 virtual Type ^ GetType();
public Type GetType ();
override this.GetType : unit -> Type
Public Function GetType () As Type

Gibt zurück

Implementiert

Gilt für: