Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Type.AssemblyQualifiedName, propriété

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)

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

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.

RemarqueRemarque

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 :

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 :

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 null.

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


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:\n   {0}.", 
                           objType.Assembly.FullName.ToString()); 

        // Print the qualified assembly name.
        Console.WriteLine ("Qualified assembly name:\n   {0}.", 
                           objType.AssemblyQualifiedName.ToString()); 
    }
}
// The example displays the following output if run under the .NET Framework 4.5:
//    Full assembly name:
//       mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.
//    Qualified assembly name:
//       System.Array, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft