DefaultValueAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.Runtime.dll

Źródło:

DefaultValueAttribute.cs

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ść domyślną na MyPropertyfalse.

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

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 pobrać element MyProperty. Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej atrybutów.

W przykładzie następnie jest wyświetlana wartość domyślna przez pobranie DefaultValueAttribute wartości z AttributeCollectionpliku 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

Element można utworzyć DefaultValueAttribute z dowolną wartością. Wartość domyślna elementu członkowskiego jest zazwyczaj jego wartością początkową. 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 być generowany dla elementu członkowskiego.

Uwaga

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

Aby uzyskać więcej informacji, zobacz Atrybuty.

Konstruktory

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 DefaultValueAttribute nowe wystąpienie klasy przy użyciu znaku Unicode.
DefaultValueAttribute(Double)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu liczby zmiennoprzecinkowe o podwójnej precyzji.
DefaultValueAttribute(Int16)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 16-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Int32)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 32-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Int64)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 64-bitowej liczby całkowitej ze znakiem.
DefaultValueAttribute(Object)	Inicjuje nowe wystąpienie klasy DefaultValueAttribute.
DefaultValueAttribute(SByte)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu SByte wartości.
DefaultValueAttribute(Single)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu liczb zmiennoprzecinkowych o pojedynczej precyzji.
DefaultValueAttribute(String)	Inicjuje DefaultValueAttribute nowe wystąpienie 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.
DefaultValueAttribute(UInt16)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu UInt16 wartości.
DefaultValueAttribute(UInt32)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu UInt32 wartości.
DefaultValueAttribute(UInt64)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu UInt64 wartości.

Właściwości

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

Metody

Equals(Object)	Zwraca, czy wartość danego obiektu jest równa bieżącej DefaultValueAttributewartości .
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu 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 Objectelementu . (Odziedziczone po Object)
SetValue(Object)	Ustawia wartość domyślną właściwości, z którą jest powiązany ten atrybut.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Attribute
• PropertyDescriptor