DefaultValueAttribute Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvény:

System.dll

Egy tulajdonság alapértelmezett értékét adja meg.

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

Öröklődés

Object

Attribute

DefaultValueAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa az alapértelmezett értéket állítja MyProperty be a következőre 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

A következő példa az alapértelmezett értéket MyPropertyellenőrzi. Először a kód lekéri PropertyDescriptorCollection az objektum összes tulajdonságát. Ezután indexel a PropertyDescriptorCollection lekéréshez MyProperty. Ezután visszaadja a tulajdonság attribútumait, és menti őket az attribútumváltozóba.

A példa ezután kinyomtatja az alapértelmezett értéket, ha beolvassa az DefaultValueAttribute értéket a AttributeCollectionkonzol képernyőjére, és beírja a nevét a konzolképernyőre.

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

Megjegyzések

Bármilyen értékkel létrehozható DefaultValueAttribute . A tagok alapértelmezett értéke általában a kezdeti érték. A vizualizációtervező az alapértelmezett érték használatával alaphelyzetbe állíthatja a tag értékét. A kódgenerátorok az alapértelmezett értékeket is használhatják annak meghatározására, hogy létre kell-e hozni a kódot a tag számára.

Note

A DefaultValueAttribute tag nem inicializálódik automatikusan az attribútum értékével. A kezdeti értéket be kell állítania a kódban.

További információ: Attribútumok.

Konstruktorok

Name	Description
DefaultValueAttribute(Boolean)	Inicializálja az DefaultValueAttribute osztály új példányát egy Boolean érték használatával.
DefaultValueAttribute(Byte)	Inicializálja az DefaultValueAttribute osztály új példányát egy 8 bites aláíratlan egész szám használatával.
DefaultValueAttribute(Char)	Unicode karakterrel inicializálja az DefaultValueAttribute osztály új példányát.
DefaultValueAttribute(Double)	Inicializálja az DefaultValueAttribute osztály új példányát dupla pontosságú lebegőpontos számmal.
DefaultValueAttribute(Int16)	Inicializálja az DefaultValueAttribute osztály új példányát egy 16 bites aláírt egész szám használatával.
DefaultValueAttribute(Int32)	Inicializálja az DefaultValueAttribute osztály új példányát egy 32 bites aláírt egész szám használatával.
DefaultValueAttribute(Int64)	Inicializálja az DefaultValueAttribute osztály új példányát egy 64 bites aláírt egész szám használatával.
DefaultValueAttribute(Object)	Inicializálja a DefaultValueAttribute osztály új példányát.
DefaultValueAttribute(Single)	Inicializálja az DefaultValueAttribute osztály új példányát egy egy pontosságú lebegőpontos számmal.
DefaultValueAttribute(String)	Inicializálja az osztály új példányát egy DefaultValueAttributeString.
DefaultValueAttribute(Type, String)	Inicializálja az DefaultValueAttribute osztály új példányát, átalakítja a megadott értéket a megadott típusra, és egy invariáns kultúrát használ fordítási környezetként.

Tulajdonságok

Name	Description
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)
Value	Lekéri annak a tulajdonságnak az alapértelmezett értékét, amelyhez az attribútum kötődik.

Metódusok

Name	Description
Equals(Object)	Azt adja vissza, hogy az adott objektum értéke megegyezik-e az aktuális DefaultValueAttributeértékkel.
GetHashCode()	A példány kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
SetValue(Object)	Beállítja annak a tulajdonságnak az alapértelmezett értékét, amelyhez az attribútum kötött.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)

Lásd még

• Attribute
• PropertyDescriptor