DefaultValueAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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) |