Module.GetType Module.GetType Module.GetType Module.GetType Method

Definition

Gibt den angegebenen Typ zurück.Returns the specified type.

Überlädt

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

Gibt den angegebenen Typ zurück. Bei der Suche wird die Groß-/Kleinschreibung beachtet.Returns the specified type, performing a case-sensitive search.

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

Durchsucht das Modul mit der angegebenen Groß-/Kleinschreibung und gibt den angegebenen Typ zurück.Returns the specified type, searching the module with the specified case sensitivity.

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

Gibt den angegebenen Typ zurück, wobei angegeben wird, ob bei der Suche im Modul die Groß- und Kleinschreibung berücksichtigt wird, und ob eine Ausnahme ausgelöst werden soll, wenn der Typ nicht gefunden werden kann.Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.

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

Gibt den angegebenen Typ zurück. Bei der Suche wird die Groß-/Kleinschreibung beachtet.Returns the specified type, performing a case-sensitive search.

public:
 virtual Type ^ GetType(System::String ^ className);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className);
override this.GetType : string -> Type
Public Overridable Function GetType (className As String) As Type

Parameter

className
String String String String

Der Name des zu suchenden Typs.The name of the type to locate. Der Name muss im Namespace vollqualifiziert sein.The name must be fully qualified with the namespace.

Gibt zurück

Ein Type-Objekt, das den angegebenen Typ darstellt, wenn der Typ sich in diesem Modul befindet; andernfalls null.A Type object representing the given type, if the type is in this module; otherwise, null.

Ausnahmen

Die Klasseninitialisierer werden aufgerufen, und eine Ausnahme wird ausgelöst.The class initializers are invoked and an exception is thrown.

className ist eine Zeichenfolge mit der Länge 0 (null).className is a zero-length string.

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

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

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

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

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

Beispiele

Im folgenden Beispiel wird der Name eines Typs im angegebenen Modul angezeigt.The following example displays the name of a type in the specified module.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing these classes.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass" );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass");
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass")
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Hinweise

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.

Ein-Typ kann von einem bestimmten Modul mithilfe Module.GetTypevon abgerufen werden.A type can be retrieved from a specific module using Module.GetType. Wenn Module.GetType Sie für das Modul aufrufen, das das Manifest enthält, wird die gesamte Assembly nicht durchsucht.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Wenn Sie einen Typ aus einer Assembly abrufen möchten, müssen Sie unabhängig von dem Modul, in dem Assembly.GetTypees sich befindet, aufrufen.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

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

Durchsucht das Modul mit der angegebenen Groß-/Kleinschreibung und gibt den angegebenen Typ zurück.Returns the specified type, searching the module with the specified case sensitivity.

public:
 virtual Type ^ GetType(System::String ^ className, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className, bool ignoreCase);
override this.GetType : string * bool -> Type
Public Overridable Function GetType (className As String, ignoreCase As Boolean) As Type

Parameter

className
String String String String

Der Name des zu suchenden Typs.The name of the type to locate. Der Name muss im Namespace vollqualifiziert sein.The name must be fully qualified with the namespace.

ignoreCase
Boolean Boolean Boolean Boolean

true für die Suche ohne Beachtung der Groß-/Kleinschreibung; andernfalls false.true for case-insensitive search; otherwise, false.

Gibt zurück

Ein Type-Objekt, das den angegebenen Typ darstellt, wenn der Typ sich in diesem Modul befindet; andernfalls null.A Type object representing the given type, if the type is in this module; otherwise, null.

Ausnahmen

Die Klasseninitialisierer werden aufgerufen, und eine Ausnahme wird ausgelöst.The class initializers are invoked and an exception is thrown.

className ist eine Zeichenfolge mit der Länge 0 (null).className is a zero-length string.

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

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

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

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

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

Beispiele

Im folgenden Beispiel wird der Name eines Typs im angegebenen Modul angezeigt, wobei für false den ignoreCase -Parameter angegeben wird, sodass der Fall nicht ignoriert wird.The following example displays the name of a type in the specified module, specifying false for the ignoreCase parameter so that case will not be ignored.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing these classes.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass", false );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Hinweise

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.

Ein-Typ kann von einem bestimmten Modul mithilfe Module.GetTypevon abgerufen werden.A type can be retrieved from a specific module using Module.GetType. Wenn Module.GetType Sie für das Modul aufrufen, das das Manifest enthält, wird die gesamte Assembly nicht durchsucht.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Wenn Sie einen Typ aus einer Assembly abrufen möchten, müssen Sie unabhängig von dem Modul, in dem Assembly.GetTypees sich befindet, aufrufen.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

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

Gibt den angegebenen Typ zurück, wobei angegeben wird, ob bei der Suche im Modul die Groß- und Kleinschreibung berücksichtigt wird, und ob eine Ausnahme ausgelöst werden soll, wenn der Typ nicht gefunden werden kann.Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.

public:
 virtual Type ^ GetType(System::String ^ className, bool throwOnError, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className, bool throwOnError, bool ignoreCase);
override this.GetType : string * bool * bool -> Type
Public Overridable Function GetType (className As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parameter

className
String String String String

Der Name des zu suchenden Typs.The name of the type to locate. Der Name muss im Namespace vollqualifiziert sein.The name must be fully qualified with the namespace.

throwOnError
Boolean Boolean Boolean Boolean

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

ignoreCase
Boolean Boolean Boolean Boolean

true für die Suche ohne Beachtung der Groß-/Kleinschreibung; andernfalls false.true for case-insensitive search; otherwise, false.

Gibt zurück

Ein Type-Objekt, das den angegebenen Typ darstellt, wenn der Typ in diesem Modul deklariert ist, andernfalls null.A Type object representing the specified type, if the type is declared in this module; otherwise, null.

Ausnahmen

Die Klasseninitialisierer werden aufgerufen, und eine Ausnahme wird ausgelöst.The class initializers are invoked and an exception is thrown.

className ist eine Zeichenfolge mit der Länge 0 (null).className is a zero-length string.

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

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

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

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

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

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

Beispiele

Im folgenden Beispiel wird der Name eines Typs im angegebenen Modul angezeigt.The following example displays the name of a type in the specified module. Der throwOnError - ignoreCase Parameter und der- falseParameter werden als angegeben.The throwOnError and ignoreCase parameters are specified as false.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing this class.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass", false, false );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing this class.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false, false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing this class.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False, False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Hinweise

Der throwOnError -Parameter wirkt sich nur darauf aus, was geschieht, wenn der Typ nicht gefunden wird.The throwOnError parameter affects only 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.

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.

Ein-Typ kann von einem bestimmten Modul mithilfe Module.GetTypevon abgerufen werden.A type can be retrieved from a specific module using Module.GetType. Wenn Module.GetType Sie für das Modul aufrufen, das das Manifest enthält, wird die gesamte Assembly nicht durchsucht.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Wenn Sie einen Typ aus einer Assembly abrufen möchten, müssen Sie unabhängig von dem Modul, in dem Assembly.GetTypees sich befindet, aufrufen.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Gilt für: