DefaultValueAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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) |