DefaultValueAttribute Classe

Definizione

Specifica il valore predefinito per una proprietà.

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
Ereditarietà
DefaultValueAttribute
Attributi

Esempio

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

private:
   bool _myVal;

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

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

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 nell'oggetto PropertyDescriptorCollection per ottenere MyProperty. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile degli attributi.

Nell'esempio viene quindi stampato il valore predefinito recuperando DefaultValueAttribute da AttributeCollectione 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.

Note

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

Nome Descrizione
DefaultValueAttribute(Boolean)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un Boolean valore .

DefaultValueAttribute(Byte)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un intero senza segno a 8 bit.

DefaultValueAttribute(Char)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un carattere Unicode.

DefaultValueAttribute(Double)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un numero a virgola mobile a precisione doppia.

DefaultValueAttribute(Int16)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un intero con segno a 16 bit.

DefaultValueAttribute(Int32)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un intero con segno a 32 bit.

DefaultValueAttribute(Int64)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un intero con segno a 64 bit.

DefaultValueAttribute(Object)

Inizializza una nuova istanza della classe DefaultValueAttribute.

DefaultValueAttribute(SByte)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un SByte valore .

DefaultValueAttribute(Single)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un numero a virgola mobile a precisione singola.

DefaultValueAttribute(String)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un oggetto String.

DefaultValueAttribute(Type, String)

Inizializza una nuova istanza della DefaultValueAttribute classe , convertendo il valore specificato nel tipo specificato e utilizzando impostazioni cultura invarianti come contesto di conversione.

DefaultValueAttribute(UInt16)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un UInt16 valore .

DefaultValueAttribute(UInt32)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un UInt32 valore .

DefaultValueAttribute(UInt64)

Inizializza una nuova istanza della DefaultValueAttribute classe utilizzando un UInt64 valore .

Proprietà

Nome Descrizione
TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)
Value

Ottiene il valore predefinito della proprietà a cui è associato questo attributo.

Metodi

Nome Descrizione
Equals(Object)

Restituisce un valore che indica se il valore dell'oggetto specificato è uguale all'oggetto corrente DefaultValueAttribute.

GetHashCode()

Restituisce il codice hash per questa istanza.

GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

Quando sottoposto a 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 è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
SetValue(Object)

Imposta il valore predefinito per la proprietà a cui è associato questo attributo.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero di interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a

Vedi anche