Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

CLSCompliantAttribute classe

 

Date de publication : novembre 2016

Indique si un élément de programme est conforme à la spécification CLS (Common Language Specification). Cette classe ne peut pas être héritée.

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

System.Object
  System.Attribute
    System.CLSCompliantAttribute

[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets.All, Inherited = true, 
	AllowMultiple = false)]
[ComVisibleAttribute(true)]
public sealed class CLSCompliantAttribute : Attribute

NomDescription
System_CAPS_pubmethodCLSCompliantAttribute(Boolean)

Initialise une instance de la CLSCompliantAttribute classe avec une valeur booléenne indiquant si l’élément de programme indiqué est conforme CLS.

NomDescription
System_CAPS_pubpropertyIsCompliant

Obtient la valeur booléenne indiquant si l’élément de programme indiqué est conforme CLS.

System_CAPS_pubpropertyTypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.(Hérité de Attribute.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Retourne une valeur qui indique si cette instance est égale à un objet spécifié.(Hérité de Attribute.)

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage de cette instance.(Hérité de Attribute.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.(Hérité de Attribute.)

System_CAPS_pubmethodMatch(Object)

En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance équivaut à un objet spécifié.(Hérité de Attribute.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.(Hérité de Attribute.)

Le CLSCompliantAttribute attribut est utilisé pour indiquer si un élément de programme particulier répond avec le Common Language Specification (CLS), qui définit les fonctionnalités que n’importe quel langage qui cible le .NET Framework doit prendre en charge. La conformité CLS est principalement un critère important pour les développeurs de bibliothèques qui souhaitent s’assurer que les bibliothèques qui leur sont accessibles dans n’importe quel langage qui cible le .NET Framework. Pour plus d'informations, consultez Indépendance du langage et composants indépendants du langage.

Vous pouvez appliquer la CLSCompliantAttribute d’attributs pour les éléments de programme suivants : assembly, module, classe, struct, enum, constructeur, méthode, propriété, champ, événement, interface, délégué, paramètre et valeur de retour. Toutefois, la notion de conformité CLS est uniquement explicite pour les assemblys, modules, types et membres de types, pas les parties d’une signature de membre. Par conséquent, CLSCompliantAttribute est ignoré lorsque appliqué au paramètre ou valeur de retour des éléments de programme.

Si aucun CLSCompliantAttribute est appliqué à un élément de programme, alors par défaut :

  • L’assembly n’est pas conforme CLS.

  • Le type est conforme CLS uniquement si son type englobant ou son assembly est conforme CLS.

  • Le membre d’un type est conforme CLS uniquement si le type est conforme CLS.

Si un assembly est marqué comme conforme CLS, tout type publiquement exposé dans l’assembly qui n’est pas conforme CLS doit être marqué avec CLSCompliantAttribute à l’aide un false argument. De même, si une classe est marquée comme conforme CLS, vous devez indiquer tous les membres qui ne sont pas conformes CLS. Tous les membres non conformes doivent fournir des alternatives conformes à CLS correspondants.

Les attributs qui sont appliqués à des assemblys ou des modules doivent être postérieure à c# using (Imports en Visual Basic) clauses et avant le code.

Pour plus d'informations sur l'utilisation d'attributs, consultez Extension des métadonnées à l'aide des attributs.

System_CAPS_noteRemarque

Le compilateur Microsoft Visual Basic actuel intentionnellement ne génère pas d’un avertissement de conformité CLS, toutefois, une version ultérieure du compilateur émet cet avertissement.

L’exemple suivant applique un CLSCompliantAttribute pour la totalité de l’assembly.

using System;
    [assembly: CLSCompliant(true)]

La déclaration suivante génère un avertissement de conformité CLS, car le type UInt32 n’est pas spécifié dans la spécification CLS.

public int SetValue(UInt32 value);

Si la déclaration est marquée avec un CLSCompliantAttribute, aucun avertissement de compilateur ou une erreur n’est générée.

[CLSCompliant(false)]
 public int SetValue(UInt32 value);

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: