DefaultValueAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.dll

Určuje výchozí hodnotu vlastnosti.

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

Dědičnost

Object

Attribute

DefaultValueAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad nastaví výchozí hodnotu MyProperty na 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

Následující příklad zkontroluje výchozí hodnotu MyProperty. Nejprve kód získá PropertyDescriptorCollection všechny vlastnosti objektu. Dále indexuje do získání PropertyDescriptorCollectionMyProperty. Pak vrátí atributy pro tuto vlastnost a uloží je do proměnné atributů.

Příklad pak vytiskne výchozí hodnotu načtením DefaultValueAttribute z objektu AttributeCollectiona zápisem jeho názvu na obrazovku konzoly.

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

Poznámky

Můžete vytvořit libovolnou DefaultValueAttribute hodnotu. Výchozí hodnota člena je obvykle jeho počáteční hodnota. Vizuální návrhář může použít výchozí hodnotu k resetování hodnoty člena. Generátory kódu mohou také použít výchozí hodnoty k určení, zda má být kód generován pro člena.

Note

A DefaultValueAttribute nezpůsobí automatické inicializaci člena s hodnotou atributu. Musíte nastavit počáteční hodnotu v kódu.

Další informace naleznete v tématu Atributy.

Konstruktory

Name	Description
DefaultValueAttribute(Boolean)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí Boolean hodnoty.
DefaultValueAttribute(Byte)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí 8bitového celého čísla bez znaménka.
DefaultValueAttribute(Char)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí znaku Unicode.
DefaultValueAttribute(Double)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí čísla s plovoucí desetinnou čárkou s dvojitou přesností.
DefaultValueAttribute(Int16)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí 16bitového signed integer.
DefaultValueAttribute(Int32)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí 32bitového signed integer.
DefaultValueAttribute(Int64)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí 64bitového signed integer.
DefaultValueAttribute(Object)	Inicializuje novou instanci DefaultValueAttribute třídy.
DefaultValueAttribute(Single)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí čísla s plovoucí desetinnou čárkou s jednoduchou přesností.
DefaultValueAttribute(String)	Inicializuje novou instanci DefaultValueAttribute třídy pomocí String.
DefaultValueAttribute(Type, String)	Inicializuje novou instanci DefaultValueAttribute třídy, převede zadanou hodnotu na zadaný typ a použije invariantní jazykovou verzi jako kontext překladu.

Vlastnosti

Name	Description
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)
Value	Získá výchozí hodnotu vlastnosti, na kterou je tento atribut vázán.

Metody

Name	Description
Equals(Object)	Vrátí, zda hodnota daného objektu je rovna aktuální DefaultValueAttribute.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
SetValue(Object)	Nastaví výchozí hodnotu vlastnosti, na kterou je tento atribut vázán.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)

Viz také

• Attribute
• PropertyDescriptor