DefaultValueAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.dll

Określa wartość domyślną właściwości.

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

Dziedziczenie

Object

Attribute

DefaultValueAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie ustawiono wartość MyProperty domyślną na falsewartość .

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

W następnym przykładzie jest sprawdzana wartość domyślna .MyProperty Najpierw kod pobiera PropertyDescriptorCollection obiekt ze wszystkimi właściwościami obiektu. Następnie indeksuje element , PropertyDescriptorCollection aby uzyskać polecenie MyProperty. Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej atrybutów.

W tym przykładzie zostanie następnie wydrukowana wartość domyślna przez pobranie DefaultValueAttribute wartości z AttributeCollectionobiektu i zapisanie jej nazwy na ekranie konsoli.

// 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()))

Uwagi

Możesz utworzyć element DefaultValueAttribute z dowolną wartością. Wartość domyślna elementu członkowskiego jest zazwyczaj jego początkową wartością. Projektant wizualizacji może użyć wartości domyślnej, aby zresetować wartość elementu członkowskiego. Generatory kodu mogą również używać wartości domyślnych, aby określić, czy kod powinien zostać wygenerowany dla elementu członkowskiego.

Note

Element DefaultValueAttribute nie spowoduje automatycznego zainicjowania elementu członkowskiego z wartością atrybutu. Musisz ustawić wartość początkową w kodzie.

Aby uzyskać więcej informacji, zobacz Atrybuty.

Konstruktory

Nazwa	Opis
DefaultValueAttribute(Boolean)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu Boolean wartości.
DefaultValueAttribute(Byte)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 8-bitowej liczby całkowitej bez znaku.
DefaultValueAttribute(Char)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu znaku Unicode.
DefaultValueAttribute(Double)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu liczby zmiennoprzecinkowych o podwójnej precyzji.
DefaultValueAttribute(Int16)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu 16-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Int32)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu 32-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Int64)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu 64-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Object)	Inicjuje nowe wystąpienie klasy DefaultValueAttribute.
DefaultValueAttribute(Single)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu liczb zmiennoprzecinkowych o pojedynczej precyzji.
DefaultValueAttribute(String)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy przy użyciu klasy String.
DefaultValueAttribute(Type, String)	Inicjuje nowe wystąpienie DefaultValueAttribute klasy, konwertuje określoną wartość na określony typ i używa niezmiennej kultury jako kontekstu tłumaczenia.

Właściwości

Nazwa	Opis
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)
Value	Pobiera wartość domyślną właściwości, z którymi jest powiązany ten atrybut.

Metody

Nazwa	Opis
Equals(Object)	Zwraca, czy wartość danego obiektu jest równa bieżącej DefaultValueAttributewartości .
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
SetValue(Object)	Ustawia wartość domyślną właściwości, do której jest powiązany ten atrybut.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

Nazwa	Opis
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt. (Odziedziczone po Attribute)

Zobacz też

• Attribute
• PropertyDescriptor