Type.AssemblyQualifiedName-Eigenschaft
Ruft den durch die Assembly qualifizierten Namen von Type ab, der den Namen der Assembly enthält, aus der der Type geladen wurde.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Property AssemblyQualifiedName As String
'Usage
Dim instance As Type
Dim value As String
value = instance.AssemblyQualifiedName
public abstract string AssemblyQualifiedName { get; }
public:
virtual property String^ AssemblyQualifiedName {
String^ get () abstract;
}
/** @property */
public abstract String get_AssemblyQualifiedName ()
public abstract function get AssemblyQualifiedName () : String
Eigenschaftenwert
Der durch die Assembly qualifizierte Name des Type, der den Namen der Assembly enthält, aus der der Type geladen wurde, oder NULL (Nothing in Visual Basic), wenn die aktuelle Instanz einen generischen Typparameter darstellt.
Hinweise
Alle Compiler, die die Common Language Runtime unterstützen, geben den einfachen Namen einer geschachtelten Klasse aus. Durch die Reflektion wird auf Anforderung ein ergänzter Name entsprechend den folgenden Konventionen gebildet.
Trennzeichen |
Bedeutung |
|---|---|
Umgekehrter Schrägstrich (\) |
Escapezeichen. |
Komma (,) |
Wird dem Assemblynamen vorangestellt. |
Pluszeichen (+) |
Wird einer geschachtelten Klasse vorangestellt. |
Punkt (.) |
Kennzeichnet Namespacebezeichner. |
Klammern ([]) |
Bezeichnet nach einem Typnamen ein Array dieses Typs. - oder - Umschließt bei einem generischen Typ die Liste der generischen Typargumente. - oder - Umschließt in einer Typargumentliste einen durch die Assembly gekennzeichneten Typ. |
Der durch die Assembly gekennzeichnete Name einer Klasse könnte z. B. wie folgt lauten:
TopNamespace.SubNameSpace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089
Falls der Namespace ein Pluszeichen enthält, z. B. TopNamespace.Sub+Namespace, wird dem Pluszeichen (+) ein Escapezeichen (\) vorangestellt, damit es nicht als Schachtelungstrennzeichen interpretiert wird. Die Reflektion gibt diese Zeichenfolge wie folgt aus:
TopNamespace.Sub\+Namespace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089
Aus "++" wird "\+\+", und aus "\" wird "\\".
Dieser gekennzeichnete Name kann beibehalten und später zum Laden des Type verwendet werden. Verwenden Sie GetType entweder nur mit dem Typnamen oder den durch die Assembly gekennzeichneten Typnamen zum Suchen und Laden eines Type. Wenn nur der Typname angegeben wird, sucht GetType nach Type in der Assembly des Aufrufers und danach in der Systemassembly. Wenn durch die Assembly gekennzeichnete Typname angegeben wird, sucht GetType nach Type in einer beliebigen Assembly.
Die Typnamen können am Ende Zeichen enthalten, die zusätzliche Informationen über den Typ angeben, z. B., ob es sich um einen Verweis-, Zeiger- oder Arraytyp handelt. Um den Typnamen ohne diese nachfolgenden Zeichen abzurufen, verwenden Sie t.GetElementType().ToString(), wobei t der Typ ist.
Außer bei Assemblynamen sind Leerzeichen in allen Komponenten von Typnamen relevant. Beim Assemblynamen sind Leerzeichen nur vor dem Trennzeichen ',' relevant, dahinter werden sie ignoriert.
Generische Argumente von generischen Typen werden selbst durch den Assemblynamen qualifiziert. Im durch die Assembly qualifizierten Typnamen für MyGenericClass<int> (MyGenericClass(Of Integer) in Visual Basic) wird int z. B. in den durch die Assembly qualifizierten Typnamen für Int32 erweitert.
Wenn das aktuelle Type-Objekt einen generischen Parameter darstellt, gibt diese Eigenschaft NULL (Nothing in Visual Basic) zurück.
Beispiel
Im folgenden Beispiel wird der der Klasse zugeordnete Assemblyname und der voll gekennzeichnete Name des Typs angezeigt.
Imports System
Imports System.Reflection
Imports Microsoft.VisualBasic
Class MyAssemblyClass
Public Shared Sub Main()
Dim objType As Type = GetType(System.Array)
' Print the full assembly name.
Console.WriteLine("Full assembly name: {0}.", objType.Assembly.FullName.ToString())
' Print the qualified assembly name.
Console.WriteLine("Qualified assembly name: {0}.", objType.AssemblyQualifiedName.ToString())
End Sub 'Main
End Class 'MyAssemblyClass
using System;
using System.Reflection;
class MyAssemblyClass
{
public static void Main()
{
Type objType = typeof(System.Array);
// Print the full assembly name.
Console.WriteLine ("Full assembly name: {0}.", objType.Assembly.FullName.ToString());
// Print the qualified assembly name.
Console.WriteLine ("Qualified assembly name: {0}.", objType.AssemblyQualifiedName.ToString());
}
}
using namespace System;
using namespace System::Reflection;
int main()
{
Type^ objType = System::Array::typeid;
// Print the full assembly name.
Console::WriteLine( "Full assembly name: {0}.", objType->Assembly->FullName );
// Print the qualified assembly name.
Console::WriteLine( "Qualified assembly name: {0}.", objType->AssemblyQualifiedName );
}
import System.*;
import System.Reflection.*;
class MyAssemblyClass
{
public static void main(String[] args)
{
Type objType = System.Array.class.ToType();
// Print the full assembly name.
Console.WriteLine("Full assembly name: {0}.",
objType.get_Assembly().get_FullName().ToString());
// Print the qualified assembly name.
Console.WriteLine("Qualified assembly name: {0}.",
objType.get_AssemblyQualifiedName().ToString());
} //main
} //MyAssemblyClass
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
Type-Klasse
Type-Member
System-Namespace
String-Klasse
GetType
FullName
Namespace
AssemblyName