Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe AmbientValueAttribute

 

Especifica o valor a ser passado para uma propriedade para fazer com que a propriedade obtenha o seu valor de outra origem. Isso é conhecido como ambiente. Essa classe não pode ser herdada.

Namespace:   System.ComponentModel
Assembly:  System (em System.dll)

System.Object
  System.Attribute
    System.ComponentModel.AmbientValueAttribute

[AttributeUsageAttribute(AttributeTargets.All)]
public sealed class AmbientValueAttribute : Attribute

NomeDescrição
System_CAPS_pubmethodAmbientValueAttribute(Boolean)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um valor booleano de seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Byte)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um inteiro não assinado de 8 bits para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Char)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um caractere Unicode de seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Double)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um número de ponto flutuante de precisão dupla para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Int16)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um inteiro assinado de 16 bits para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Int32)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um inteiro assinado de 32 bits para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Int64)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um inteiro assinado de 64 bits para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Object)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um objeto para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Single)

Inicializa uma nova instância de AmbientValueAttribute classe, dado um número de ponto flutuante de precisão simples para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(String)

Inicializa uma nova instância de AmbientValueAttribute classe, dada uma cadeia de caracteres para seu valor.

System_CAPS_pubmethodAmbientValueAttribute(Type, String)

Inicializa uma nova instância do AmbientValueAttribute classe, o valor e seu tipo.

NomeDescrição
System_CAPS_pubpropertyTypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.(Herdado de Attribute.)

System_CAPS_pubpropertyValue

Obtém o objeto que é o valor desse AmbientValueAttribute.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Determina se o especificada AmbientValueAttribute é igual a atual AmbientValueAttribute.(Substitui o Attribute.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Retorna o hash code para essa instância. (Substitui o Attribute.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodIsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.(Herdado de Attribute.)

System_CAPS_pubmethodMatch(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.(Herdado de Attribute.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.(Herdado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface.(Herdado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

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

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.(Herdado de Attribute.)

If a property on a control has ambient behavior, this attribute must be present. Ambient properties query their parent for their value, for example, a P:System.Windows.Forms.Control.Font property or a P:System.Windows.Forms.Control.BackColor property.

Typically, a visual designer uses the T:System.ComponentModel.AmbientValueAttribute attribute to decide which value to persist for a property. This is usually a value that causes the property to get its value from another source. An example of an ambient value is F:System.Drawing.Color.Empty as the ambient value for the P:System.Windows.Forms.Control.BackColor property. If you have a control on a form and the P:System.Windows.Forms.Control.BackColor property of the control is set to a different color than the P:System.Windows.Forms.Control.BackColor property of the form, you can reset the P:System.Windows.Forms.Control.BackColor property of the control to that of the form by setting the P:System.Windows.Forms.Control.BackColor of the control to F:System.Drawing.Color.Empty.

The following code example demonstrates using T:System.ComponentModel.AmbientValueAttribute to enforce ambient behavior for a property called AlertForeColor. For a full code listing, see How to: Apply Attributes in Windows Forms Controls.

[AmbientValue(typeof(Color), "Empty")]
[Category("Appearance")]
[DefaultValue(typeof(Color), "White")]
[Description("The color used for painting alert text.")]
public Color AlertForeColor
{
    get
    {
        if (this.alertForeColorValue == Color.Empty &&
            this.Parent != null)
        {
            return Parent.ForeColor;
        }

        return this.alertForeColorValue;
    }

    set
    {
        this.alertForeColorValue = value;
    }
}

// This method is used by designers to enable resetting the
// property to its default value.
public void ResetAlertForeColor()
{
    this.AlertForeColor = AttributesDemoControl.defaultAlertForeColorValue;
}

// This method indicates to designers whether the property
// value is different from the ambient value, in which case
// the designer should persist the value.
private bool ShouldSerializeAlertForeColor()
{
    return (this.alertForeColorValue != AttributesDemoControl.ambientColorValue);
}

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: