DefaultValueAttribute Classe

Definição

Especifica o valor padrão de uma propriedade.

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
Herança
DefaultValueAttribute
Atributos

Exemplos

O exemplo seguinte define o valor padrão de MyProperty para 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

O próximo exemplo verifica o valor padrão de MyProperty. Primeiro, o código recebe uma PropertyDescriptorCollection com todas as propriedades do objeto. De seguida, indexa em para PropertyDescriptorCollection obter MyProperty. Depois, devolve os atributos dessa propriedade e guarda-os na variável de atributos.

O exemplo imprime então o valor padrão recuperando o DefaultValueAttribute do AttributeCollection, e escrevendo o seu nome no ecrã da consola.

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

Observações

Podes criar um com DefaultValueAttribute qualquer valor. O valor padrão de um membro é tipicamente o seu valor inicial. Um designer visual pode usar o valor padrão para redefinir o valor do membro. Os geradores de código também podem usar os valores padrão para determinar se deve ser gerado código para o membro.

Note

A DefaultValueAttribute não fará com que um membro seja automaticamente inicializado com o valor do atributo. Deve definir o valor inicial no seu código.

Para obter mais informações, consulte Atributos.

Construtores

Name Description
DefaultValueAttribute(Boolean)

Inicializa uma nova instância da DefaultValueAttribute classe usando um Boolean valor.

DefaultValueAttribute(Byte)

Inicializa uma nova instância da DefaultValueAttribute classe usando um inteiro sem sinal de 8 bits.

DefaultValueAttribute(Char)

Inicializa uma nova instância da DefaultValueAttribute classe usando um carácter Unicode.

DefaultValueAttribute(Double)

Inicializa uma nova instância da DefaultValueAttribute classe usando um número de ponto flutuante de dupla precisão.

DefaultValueAttribute(Int16)

Inicializa uma nova instância da DefaultValueAttribute classe usando um inteiro assinado de 16 bits.

DefaultValueAttribute(Int32)

Inicializa uma nova instância da DefaultValueAttribute classe usando um inteiro assinado de 32 bits.

DefaultValueAttribute(Int64)

Inicializa uma nova instância da DefaultValueAttribute classe usando um inteiro assinado de 64 bits.

DefaultValueAttribute(Object)

Inicializa uma nova instância da DefaultValueAttribute classe.

DefaultValueAttribute(SByte)

Inicializa uma nova instância da DefaultValueAttribute classe usando um SByte valor.

DefaultValueAttribute(Single)

Inicializa uma nova instância da DefaultValueAttribute classe usando um número de ponto flutuante de precisão simples.

DefaultValueAttribute(String)

Inicializa uma nova instância da DefaultValueAttribute classe usando um String.

DefaultValueAttribute(Type, String)

Inicializa uma nova instância da DefaultValueAttribute classe, convertendo o valor especificado para o tipo especificado e usando uma cultura invariante como contexto de tradução.

DefaultValueAttribute(UInt16)

Inicializa uma nova instância da DefaultValueAttribute classe usando um UInt16 valor.

DefaultValueAttribute(UInt32)

Inicializa uma nova instância da DefaultValueAttribute classe usando um UInt32 valor.

DefaultValueAttribute(UInt64)

Inicializa uma nova instância da DefaultValueAttribute classe usando um UInt64 valor.

Propriedades

Name Description
TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)
Value

Obtém o valor padrão da propriedade a que este atributo está vinculado.

Métodos

Name Description
Equals(Object)

Devolve se o valor do objeto dado é igual à corrente DefaultValueAttribute.

GetHashCode()

Devolve o código de hash para esta instância.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
SetValue(Object)

Define o valor padrão para a propriedade à qual este atributo está vinculado.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a

Ver também