Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez le processus suivant pour appliquer un attribut à un élément de votre code.
Définissez un nouvel attribut ou utilisez un attribut .NET existant.
Appliquez l’attribut à l’élément de code en le plaçant immédiatement avant l’élément.
Chaque langage a sa propre syntaxe d’attribut. En C++ et C#, l’attribut est encadré par des crochets et séparé de l’élément par un espace blanc, ce qui peut inclure un saut de ligne. Dans Visual Basic, l’attribut est entouré de crochets d’angle et doit se trouver sur la même ligne logique ; le caractère de continuation de ligne peut être utilisé si un saut de ligne est souhaité.
Spécifiez les paramètres positionnels et les paramètres nommés pour l’attribut.
Les paramètres positionnels sont requis et doivent être fournis avant tous les paramètres nommés ; ils correspondent aux paramètres de l’un des constructeurs de l’attribut. Les paramètres nommés sont facultatifs et correspondent aux propriétés de lecture/écriture de l’attribut. Dans C++et C#, spécifiez
name=value
pour chaque paramètre facultatif, oùname
est le nom de la propriété. Dans Visual Basic, spécifiezname:=value
.
L’attribut est émis dans des métadonnées lorsque vous compilez votre code et qu’il est disponible pour le Common Language Runtime et tout outil ou application personnalisé via les services de réflexion du runtime.
Par convention, tous les noms d’attributs se terminent par « Attribut ». Toutefois, plusieurs langages qui ciblent le runtime, tels que Visual Basic et C#, ne vous obligent pas à spécifier le nom complet d’un attribut. Par exemple, si vous souhaitez initialiser System.ObsoleteAttribute, vous devez uniquement la référencer comme obsolète.
Appliquer un attribut à une méthode
L’exemple de code suivant montre comment utiliser System.ObsoleteAttribute, qui marque le code comme obsolète. La chaîne "Will be removed in next version"
est passée à l’attribut. Cet attribut provoque un avertissement du compilateur qui affiche la chaîne passée lorsque le code décrit par l’attribut est appelé.
public class Example
{
// Specify attributes between square brackets in C#.
// This attribute is applied only to the Add method.
[Obsolete("Will be removed in next version.")]
public static int Add(int a, int b)
{
return (a + b);
}
}
class Test
{
public static void Main()
{
// This generates a compile-time warning.
int i = Example.Add(2, 2);
}
}
Public Class Example
' Specify attributes between square brackets in C#.
' This attribute is applied only to the Add method.
<Obsolete("Will be removed in next version.")>
Public Shared Function Add(a As Integer, b As Integer) As Integer
Return a + b
End Function
End Class
Class Test
Public Shared Sub Main()
' This generates a compile-time warning.
Dim i As Integer = Example.Add(2, 2)
End Sub
End Class
Appliquer des attributs au niveau de l’assembly
Si vous souhaitez appliquer un attribut au niveau de l’assembly, utilisez le assembly
mot clé (Assembly
en Visual Basic). Le code suivant montre l'application de AssemblyTitleAttribute au niveau de l'assemblage.
using System.Reflection;
[assembly:AssemblyTitle("My Assembly")]
Imports System.Reflection
<Assembly: AssemblyTitle("My Assembly")>
Lorsque cet attribut est appliqué, la chaîne "My Assembly"
est placée dans le manifeste d’assembly dans la partie métadonnées du fichier. Vous pouvez afficher l’attribut à l’aide du désassembleur IL (Ildasm.exe) ou en créant un programme personnalisé pour récupérer l’attribut.