DefaultValueAttribute Classe

Référence

Définition

Espace de noms:: System.ComponentModel

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie la valeur par défaut d'une propriété.

public ref class DefaultValueAttribute : Attribute

public ref class DefaultValueAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public class DefaultValueAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DefaultValueAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type DefaultValueAttribute = class
    inherit Attribute

Public Class DefaultValueAttribute
Inherits Attribute

Public NotInheritable Class DefaultValueAttribute
Inherits Attribute

Héritage: Object

Attribute
DefaultValueAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple suivant définit la valeur MyProperty falsepar défaut sur .

private:
   bool _myVal;

public:
   [DefaultValue(false)]
   property bool MyProperty 
   {
      bool get()
      {
         return _myVal;
      }

      void set( bool value )
      {
         _myVal = value;
      }
   }


private bool _myVal = false;

[DefaultValue(false)]
public bool MyProperty
{
    get
    {
        return _myVal;
    }
    set
    {
        _myVal = value;
    }
}


Private _myVar As Boolean = False

<DefaultValue(False)>
Public Property MyProperty() As Boolean
    Get
        Return _myVar
    End Get
    Set
        _myVar = Value
    End Set
End Property

L’exemple suivant vérifie la valeur par défaut .MyProperty Tout d’abord, le code obtient une PropertyDescriptorCollection avec toutes les propriétés de l’objet. Ensuite, il indexe dans le PropertyDescriptorCollection pour obtenir MyProperty. Ensuite, il retourne les attributs de cette propriété et les enregistre dans la variable d’attributs.

L’exemple imprime ensuite la valeur par défaut en récupérant le DefaultValueAttribute code à partir de l’écran AttributeCollectionde console et en écrivant son nom sur l’écran de la console.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyProperty" ]->Attributes;

/* Prints the default value by retrieving the DefaultValueAttribute 
      * from the AttributeCollection. */
DefaultValueAttribute^ myAttribute = dynamic_cast<DefaultValueAttribute^>(attributes[ DefaultValueAttribute::typeid ]);
Console::WriteLine( "The default value is: {0}", myAttribute->Value );

// Gets the attributes for the property.
AttributeCollection attributes =
    TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

/* Prints the default value by retrieving the DefaultValueAttribute 
 * from the AttributeCollection. */
DefaultValueAttribute myAttribute =
    (DefaultValueAttribute) attributes[typeof(DefaultValueAttribute)];
Console.WriteLine("The default value is: " + myAttribute.Value.ToString());

' Gets the attributes for the property.
Dim attributes As AttributeCollection =
        TypeDescriptor.GetProperties(Me)("MyProperty").Attributes

' Prints the default value by retrieving the DefaultValueAttribute
' from the AttributeCollection. 
Dim myAttribute As DefaultValueAttribute =
        CType(attributes(GetType(DefaultValueAttribute)), DefaultValueAttribute)
Console.WriteLine(("The default value is: " & myAttribute.Value.ToString()))

Remarques

Vous pouvez créer une DefaultValueAttribute valeur avec n’importe quelle valeur. La valeur par défaut d’un membre est généralement sa valeur initiale. Un concepteur visuel peut utiliser la valeur par défaut pour réinitialiser la valeur du membre. Les générateurs de code peuvent également utiliser les valeurs par défaut pour déterminer si le code doit être généré pour le membre.

Notes

Un DefaultValueAttribute membre n’est pas automatiquement initialisé avec la valeur de l’attribut. Vous devez définir la valeur initiale dans votre code.

Pour plus d’informations, consultez Attributs.

Constructeurs

DefaultValueAttribute(Boolean)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec une valeur Boolean.
DefaultValueAttribute(Byte)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un entier 8 bits non signé.
DefaultValueAttribute(Char)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un caractère Unicode.
DefaultValueAttribute(Double)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un nombre à virgule flottante double précision.
DefaultValueAttribute(Int16)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un entier 16 bits signé.
DefaultValueAttribute(Int32)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un entier signé 32 bits.
DefaultValueAttribute(Int64)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un entier signé 64 bits.
DefaultValueAttribute(Object)	Initialise une nouvelle instance de la classe DefaultValueAttribute.
DefaultValueAttribute(SByte)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec une valeur SByte.
DefaultValueAttribute(Single)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un nombre à virgule flottante simple précision.
DefaultValueAttribute(String)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec un String.
DefaultValueAttribute(Type, String)	Initialise une nouvelle instance de la classe DefaultValueAttribute, en convertissant la valeur spécifiée en type spécifié et en utilisant une culture dite indifférente comme contexte de traduction.
DefaultValueAttribute(UInt16)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec une valeur UInt16.
DefaultValueAttribute(UInt32)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec une valeur UInt32.
DefaultValueAttribute(UInt64)	Initialise une nouvelle instance de la classe DefaultValueAttribute avec une valeur UInt64.

Propriétés

TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Value	Obtient la valeur par défaut de la propriété à laquelle cet attribut est lié.

Méthodes

Equals(Object)	Retourne une valeur indiquant si la valeur de l'objet donné est égale au DefaultValueAttribute en cours.
GetHashCode()	Retourne le code de hachage de cette instance.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	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)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SetValue(Object)	Définit la valeur par défaut de la propriété à laquelle cet attribut est lié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_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)
_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)
_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)

S’applique à