Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Type.AssemblyQualifiedName, propriété

.NET Framework 4

Autres versions

Obtient le nom qualifié d'assembly du Type, y compris le nom de l'assembly à partir duquel le Type a été chargé.

Espace de noms : System
Assembly : mscorlib (dans mscorlib.dll)

Syntaxe

C++

Copier

public abstract string AssemblyQualifiedName { get; }

Valeur de propriété

Type : System.String
Le nom qualifié d'assembly du Type, qui inclut le nom de l'assembly à partir duquel le Type a été chargé ou null si l'instance actuelle représente un paramètre de type générique.

Implémentations

_Type.AssemblyQualifiedName

Notes

Le nom qualifié d'assembly d'un type se compose du nom de type, y compris son espace de noms, suivi d'une virgule, elle-même suivie du nom complet de l'assembly. Le nom complet d'un assembly est obtenu à l'aide de la propriété Assembly.FullName.

Remarque
Dans .NET Framework version 2.0, l'architecture de processeur est ajoutée à l'identité de l'assembly et peut être spécifiée comme faisant partie de chaînes de noms d'assemblys. Par exemple, "ProcessorArchitecture=msil". Toutefois, pour des raisons de compatibilité, elle n'est pas incluse dans la chaîne retournée par la propriété AssemblyQualifiedName. Consultez AssemblyName.ProcessorArchitecture.

Remarque

Dans .NET Framework version 2.0, l'architecture de processeur est ajoutée à l'identité de l'assembly et peut être spécifiée comme faisant partie de chaînes de noms d'assemblys. Par exemple, "ProcessorArchitecture=msil". Toutefois, pour des raisons de compatibilité, elle n'est pas incluse dans la chaîne retournée par la propriété AssemblyQualifiedName. Consultez AssemblyName.ProcessorArchitecture.

Tous les compilateurs qui prennent en charge le Common Language Runtime émettent le nom simple d'une classe imbriquée et la réflexion construit un nom tronqué sur demande, conformément aux conventions suivantes.

Delimiter	Signification
barre oblique inverse (\)	Caractère d'échappement.
Virgule (,)	Précède le nom de l'assembly.
Signe plus (+)	Précède une classe imbriquée.
Point (.)	Indique des identificateurs d'espaces de noms.
Crochets ([])	Après un nom de type, dénote un tableau de ce type. ou Pour un type générique, englobe la liste des arguments de type générique. ou Dans une liste d'arguments de type, englobe un type qualifié d'assembly.

Par exemple, le nom qualifié d'assembly d'une classe peut ressembler à ceci :

Copier

TopNamespace.SubNameSpace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089

Si l'espace de noms contenait un signe plus, par exemple TopNamespace.Sub+Namespace, le signe plus (+) serait précédé d'un caractère d'échappement (\) pour l'empêcher d'être interprété comme un séparateur d'imbrication. La réflexion émettrait cette chaîne comme suit :

Copier

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass, MyAssembly, Version=1.3.0.0, Culture=neutral, PublicKeyToken=b17a5c561934e089

"++" devient "\+\+" et "\" devient "\\".

Ce nom qualifié peut être persistant et utilisé ultérieurement pour charger Type. Pour rechercher et charger un Type, utilisez GetType avec le nom de type ou avec le nom de type qualifié d'assembly. GetType avec le nom de type recherchera seulement le Type dans l'assembly de l'appelant puis dans l'assembly System. GetType avec le nom de type qualifié de l'assembly recherchera le Type dans tous les assemblys.

Les noms de types peuvent présenter des caractères de fin qui apportent des précisions sur le type, indiquant notamment s'il s'agit d'un type référence, d'un type pointeur ou d'un type tableau. Pour récupérer le nom de type sans ces caractères de fin, utilisez t.GetElementType().ToString(), où t est le type.

Des espaces peuvent être appliqués dans tous les composants de nom de type, sauf dans le nom d'assembly. Dans le nom d'assembly, des espaces peuvent être appliqués avant le séparateur ",", mais les espaces situés après le séparateur "," sont ignorés.

Les arguments génériques de types génériques sont eux-mêmes qualifiés par le nom d'assembly. Par exemple, dans le nom de type qualifié d'assembly pour MyGenericClass<int> (MyGenericClass(Of Integer) en Visual Basic), int est développé avec le nom de type qualifié d'assembly pour Int32.

Si l'objet Type actuel représente un paramètre générique, cette propriété retourne la valeur null.

Exemples

L'exemple suivant affiche le nom d'assembly associé à la classe et le nom qualifié complet du type.

C++

Copier


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()); 
    }
}

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi