DefaultValueAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.Runtime.dll

Source:

DefaultValueAttribute.cs

Specifica il valore predefinito per una proprietà.

public ref class DefaultValueAttribute : Attribute

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

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

Public Class DefaultValueAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

DefaultValueAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene impostato il valore predefinito di MyProperty su false.

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

Nell'esempio seguente viene controllato il valore predefinito di MyProperty. Prima di tutto, il codice ottiene un PropertyDescriptorCollection oggetto con tutte le proprietà per l'oggetto . Successivamente, indicizza in PropertyDescriptorCollection per ottenere MyProperty. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile degli attributi.

L'esempio stampa quindi il valore predefinito recuperando dall'oggetto DefaultValueAttributeAttributeCollectione scrivendone il nome nella schermata della 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()))

Commenti

È possibile creare un oggetto DefaultValueAttribute con qualsiasi valore. Il valore predefinito di un membro è in genere il valore iniziale. Una finestra di progettazione visiva può usare il valore predefinito per reimpostare il valore del membro. I generatori di codice possono usare anche i valori predefiniti per determinare se il codice deve essere generato per il membro.

Nota

Un DefaultValueAttribute oggetto non causerà l'inizializzazione automatica di un membro con il valore dell'attributo. È necessario impostare il valore iniziale nel codice.

Per altre informazioni, vedere Attributi.

Costruttori

DefaultValueAttribute(Boolean)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un valore Boolean.
DefaultValueAttribute(Byte)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un intero senza segno a 8 bit.
DefaultValueAttribute(Char)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un carattere Unicode.
DefaultValueAttribute(Double)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un numero in virgola mobile e precisione doppia.
DefaultValueAttribute(Int16)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un intero con segno a 16 bit.
DefaultValueAttribute(Int32)	Inizializza una nuova istanza della classe DefaultValueAttribute usando un intero con segno a 32 bit.
DefaultValueAttribute(Int64)	Inizializza una nuova istanza della classe DefaultValueAttribute usando un intero con segno a 64 bit.
DefaultValueAttribute(Object)	Inizializza una nuova istanza della classe DefaultValueAttribute.
DefaultValueAttribute(SByte)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un valore SByte.
DefaultValueAttribute(Single)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un numero in virgola mobile e precisione singola.
DefaultValueAttribute(String)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando una classe String.
DefaultValueAttribute(Type, String)	Consente di inizializzare una nuova istanza della classe DefaultValueAttribute, convertendo il valore specificato nel tipo indicato e utilizzando le impostazioni cultura invarianti come contesto di conversione.
DefaultValueAttribute(UInt16)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un valore UInt16.
DefaultValueAttribute(UInt32)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un valore UInt32.
DefaultValueAttribute(UInt64)	Inizializza una nuova istanza della classe DefaultValueAttribute utilizzando un valore UInt64.

Proprietà

TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
Value	Ottiene il valore predefinito della proprietà a cui è associato questo attributo.

Metodi

Equals(Object)	Specifica se il valore dell'oggetto specificato è uguale all'oggetto DefaultValueAttribute corrente.
GetHashCode()	Restituisce il codice hash per l'istanza.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SetValue(Object)	Imposta il valore predefinito della proprietà a cui è associato questo attributo.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Attribute
• PropertyDescriptor