Version imprimable       Envoyer     
Cliquez pour évaluer et commenter
MSDN
MSDN Library
Visual Studio .NET
Visual Basic et Visual C#
Réference
Langage Visual C#
Spécifications du langage C#
 B.3.1 Format de la chaîne d'identif...

  Passer à l'affichage pour faible bande passante
Spécifications du langage C#
B.3.1 Format de la chaîne d'identification

Lorsqu'il génère les chaînes d'identification, le générateur de documentation respecte les règles suivantes :

  • La chaîne ne doit contenir aucun espace.
  • La première partie de la chaîne identifie le type de membre documenté, à l'aide d'un caractère unique suivi de deux points. Les types de membres suivants sont définis :
    Caractère Description
    E Événement
    F Champ
    M Méthode (incluant des constructeurs, des destructeurs et des opérateurs)
    N Espace de noms
    P Propriété (incluant des indexeurs)
    T Type (tel que class, delegate, enum, interface et struct)
    ! Chaîne d'erreur ; le reste de la chaîne fournit des informations sur l'erreur. Par exemple, le générateur de documentation génère des informations d'erreur pour les liens impossibles à résoudre.
  • La deuxième partie de la chaîne est composée du nom qualifié complet de l'élément, à partir de la racine de l'espace de noms. Le nom de l'élément, son ou ses types englobants et l'espace de noms sont séparés par des points. Si le nom de l'élément lui-même comporte des points, ils sont remplacés par les caractères # (U+0023). Par principe, aucun élément ne comporte ce caractère dans son nom.
  • Pour les méthodes et propriétés avec arguments, la liste d'arguments suit entre parenthèses. Pour celles sans arguments, les parenthèses sont omises. Les arguments sont séparés par des virgules. Le codage de chaque argument est identique à une signature CLI : les arguments sont représentés par leur nom qualifié complet. Par exemple, int devient System.Int32, string devient System.String, object devient System.Object, etc. @ suit le nom de type des arguments ayant le modificateur out ou ref. Les arguments passés par valeur ou par l'intermédiaire de params n'ont pas de notation spéciale. Les arguments qui sont des tableaux sont représentés par [ limite_inférieure : taille , ... , limite_inférieure : taille ], où le nombre de virgules correspond au rang - 1, et la limite inférieure et la taille de chaque dimension, lorsqu'elles sont connues, sont représentées sous forme décimale. Lorsqu'une limite inférieure ou une taille n'est pas spécifiée, elle est omise. Si la limite inférieure et la taille d'une dimension particulière sont omises, le signe « : » est également omis. Les tableaux en escalier sont représentés par un « [] » par niveau. Les arguments qui ont des types de pointeurs autres que void sont représentés par un * suivant le nom de type. Un pointeur void est représenté à l'aide du nom de type System.Void.
© 2009 Microsoft Corporation. Tous droits réservés. Conditions d'utilisation  |  Marques  |  Confidentialité
Page view tracker