Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

AmbientValueAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Gibt den Wert auf eine Eigenschaft, die dazu führen, dass die Eigenschaft zum Abrufen des Werts aus einer anderen Quelle übergeben. Dies wird als bezeichnet Umgebung. Diese Klasse kann nicht vererbt werden.

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

System.Object
  System.Attribute
    System.ComponentModel.AmbientValueAttribute

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

NameBeschreibung
System_CAPS_pubmethodAmbientValueAttribute(Boolean)

Initialisiert eine neue Instanz der AmbientValueAttribute -Klasse mit einem booleschen Wert als Wert.

System_CAPS_pubmethodAmbientValueAttribute(Byte)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine 8-Bit-Ganzzahl ohne Vorzeichen.

System_CAPS_pubmethodAmbientValueAttribute(Char)

Initialisiert eine neue Instanz der AmbientValueAttribute -Klasse mit einem Unicode-Zeichen als Wert.

System_CAPS_pubmethodAmbientValueAttribute(Double)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine Gleitkommazahl mit doppelter Genauigkeit.

System_CAPS_pubmethodAmbientValueAttribute(Int16)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine 16-Bit-Ganzzahl mit Vorzeichen.

System_CAPS_pubmethodAmbientValueAttribute(Int32)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine 32-Bit-Ganzzahl mit Vorzeichen.

System_CAPS_pubmethodAmbientValueAttribute(Int64)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine 64-Bit-Ganzzahl mit Vorzeichen.

System_CAPS_pubmethodAmbientValueAttribute(Object)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, die ein Objekt als Wert zugewiesen.

System_CAPS_pubmethodAmbientValueAttribute(Single)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern für ihren Wert eine Gleitkommazahl mit einfacher Genauigkeit.

System_CAPS_pubmethodAmbientValueAttribute(String)

Initialisiert eine neue Instanz der AmbientValueAttribute -Klasse mit einer Zeichenfolge als Wert.

System_CAPS_pubmethodAmbientValueAttribute(Type, String)

Initialisiert eine neue Instanz der der AmbientValueAttribute Klasse, sofern der Wert und dessen Typ.

NameBeschreibung
System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

System_CAPS_pubpropertyValue

Ruft das Objekt ab, das der Wert dieses AmbientValueAttribute.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene AmbientValueAttribute und das aktuelle AmbientValueAttribute gleich sind.(Überschreibt Attribute.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Überschreibt Attribute.GetHashCode().)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

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

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Wenn eine Eigenschaft eines Steuerelements ambient Verhalten aufweist, muss dieses Attribut vorhanden sein. Umgebungseigenschaften Fragen ihre übergeordnete Eigenschaft nach deren Wert ab, z. B. ein Control.Font Eigenschaft oder ein Control.BackColor Eigenschaft.

Ein visueller Designer in der Regel mithilfe der AmbientValueAttribute Attribut, um zu entscheiden, welcher Wert für eine Eigenschaft beibehalten. Dies ist normalerweise ein Wert, der bewirkt, die Eigenschaft zum Abrufen des Werts aus einer anderen Quelle dass. Ein Beispiel für ein ambient-Wert ist Color.Empty als der Wert für die BackColor Eigenschaft. Wenn Sie ein Steuerelement in einem Formular und die BackColor -Eigenschaft des Steuerelements festgelegt ist, auf eine andere Farbe als die BackColor -Eigenschaft des Formulars, können Sie Zurücksetzen der BackColor -Eigenschaft des Steuerelements, des Formulars durch Festlegen der BackColor des Steuerelements Color.Empty.

Das folgende Codebeispiel veranschaulicht die Verwendung AmbientValueAttribute erzwingen ambient Verhalten für eine Eigenschaft mit dem Namen AlertForeColor. Eine vollständige Codebeispiel finden Sie unter Gewusst wie: Anwenden von Attributen auf Windows Forms-Steuerelemente.

[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
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: