DefaultValueAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.Runtime.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

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

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

Dziedziczenie

Object

Attribute

DefaultValueAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie ustawiono wartość domyślną na MyProperty 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

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

W tym przykładzie zostanie wydrukowana wartość domyślna, pobierając element z elementu AttributeCollectioni zapisując DefaultValueAttribute jego nazwę 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 to zazwyczaj jego wartość początkowa. 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.

Uwaga

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

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 zmiennoprzecinkowych o podwójnej precyzji.
DefaultValueAttribute(Int16)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 16-bitowej liczby całkowitej z podpisem.
DefaultValueAttribute(Int32)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 32-bitowej liczby całkowitej z podpisem.
DefaultValueAttribute(Int64)	Inicjuje DefaultValueAttribute nowe wystąpienie klasy przy użyciu 64-bitowej liczby całkowitej z podpisem.
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, do której 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()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną 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, do której jest powiązany ten atrybut.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_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 dla obiektu, który może służyć do pobierania 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)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Zobacz też

• Attribute
• PropertyDescriptor