Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase AmbientValueAttribute

 

Publicado: octubre de 2016

Especifica el valor para pasar a una propiedad para hacer que la propiedad obtenga su valor de otro origen. Esto se conoce como ambiente. Esta clase no puede heredarse.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.Attribute
    System.ComponentModel.AmbientValueAttribute

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

NombreDescripción
System_CAPS_pubmethodAmbientValueAttribute(Boolean)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un valor booleano como valor.

System_CAPS_pubmethodAmbientValueAttribute(Byte)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un entero de 8 bits sin signo como valor.

System_CAPS_pubmethodAmbientValueAttribute(Char)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un carácter Unicode como valor.

System_CAPS_pubmethodAmbientValueAttribute(Double)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un número de punto flotante de precisión doble como valor.

System_CAPS_pubmethodAmbientValueAttribute(Int16)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un entero de 16 bits con signo como valor.

System_CAPS_pubmethodAmbientValueAttribute(Int32)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un entero de 32 bits con signo como valor.

System_CAPS_pubmethodAmbientValueAttribute(Int64)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un entero de 64 bits con signo como valor.

System_CAPS_pubmethodAmbientValueAttribute(Object)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un objeto como su valor.

System_CAPS_pubmethodAmbientValueAttribute(Single)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado un número de punto flotante de precisión sencilla como valor.

System_CAPS_pubmethodAmbientValueAttribute(String)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dada una cadena como su valor.

System_CAPS_pubmethodAmbientValueAttribute(Type, String)

Inicializa una nueva instancia de la AmbientValueAttribute (clase), dado el valor y su tipo.

NombreDescripción
System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyValue

Obtiene el objeto que es el valor de este AmbientValueAttribute.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto AmbientValueAttribute especificado es igual al objeto AmbientValueAttribute actual.(Invalida Attribute.Equals(Object)).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Invalida Attribute.GetHashCode()).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.(Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).

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

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Si una propiedad de un control tiene un comportamiento ambiente, este atributo debe estar presente. Propiedades de ambiente consultan su elemento primario para su valor, por ejemplo, un Control.Font propiedad o un Control.BackColor propiedad.

Normalmente, un diseñador visual utiliza el AmbientValueAttribute atributo para decidir qué valor desea conservar para una propiedad. Por lo general, suele ser un valor que hace que la propiedad obtenga su valor de otro origen. Un ejemplo de un valor ambiente es Color.Empty como valor ambiente de la BackColor propiedad. Si tiene un control en un formulario y el BackColor propiedad del control se establece en un color diferente que el BackColor propiedad del formulario, puede restablecer el BackColor propiedad del control a la del formulario estableciendo la BackColor del control Color.Empty.

En el ejemplo de código siguiente se muestra cómo utilizar AmbientValueAttribute para exigir el comportamiento ambiente de una propiedad denominada AlertForeColor. Para obtener una lista de código completo, vea Cómo: Aplicar atributos en controles de formularios Windows Forms.

[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
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: