AmbientValueAttribute Clase
TOC
Collapse the table of content
Expand the table of content
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

AmbientValueAttribute (Clase)

 

Especifica el valor para pasar a una propiedad que hace 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 clase AmbientValueAttribute, dado un valor booleano como valor.

System_CAPS_pubmethodAmbientValueAttribute(Byte)

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

System_CAPS_pubmethodAmbientValueAttribute(Char)

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

System_CAPS_pubmethodAmbientValueAttribute(Double)

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

System_CAPS_pubmethodAmbientValueAttribute(Int16)

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

System_CAPS_pubmethodAmbientValueAttribute(Int32)

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

System_CAPS_pubmethodAmbientValueAttribute(Int64)

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

System_CAPS_pubmethodAmbientValueAttribute(Object)

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

System_CAPS_pubmethodAmbientValueAttribute(Single)

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

System_CAPS_pubmethodAmbientValueAttribute(String)

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

System_CAPS_pubmethodAmbientValueAttribute(Type, String)

Inicializa una nueva instancia de la clase AmbientValueAttribute, dados 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 AmbientValueAttribute.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si la estructura AmbientValueAttribute especificada es igual que la estructura AmbientValueAttribute actual.(Reemplaza a Attribute.Equals(Object)).

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodIsDefaultAttribute()

Cuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para 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 al objeto especificado. (Heredado de Attribute.)

System_CAPS_pubmethodToString()

Retorna una cadena que representa al 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 del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra 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 en un control tiene un comportamiento ambiente, este atributo deberá estar presente.Las propiedades ambiente consultan a sus propiedades principales acerca de su valor; por ejemplo, una propiedad Control.Font o una propiedad Control.BackColor.

Normalmente, un diseñador visual utiliza el atributo AmbientValueAttribute para decidir qué valor se ha de conservar para una propiedad.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 propiedad BackColor.Si hay un control en un formulario y la propiedad BackColor del control está establecida en un color diferente al de la propiedad BackColor del formulario, se puede restablecer la propiedad BackColor del control en la del formulario estableciendo la propiedad BackColor del control en Color.Empty.

El ejemplo de código siguiente muestra cómo utilizar AmbientValueAttribute para exigir el comportamiento ambiente de una propiedad llamada AlertForeColor.Para obtener una lista de código completa, 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

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft