(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DefaultSettingValueAttribute-Klasse

Gibt den Standardwert für eine Anwendungseinstellungseigenschaft an.

System.Object
  System.Attribute
    System.Configuration.DefaultSettingValueAttribute

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

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class DefaultSettingValueAttribute : Attribute

Der DefaultSettingValueAttribute-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeDefaultSettingValueAttributeInitialisiert eine Instanz der DefaultSettingValueAttribute-Klasse.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftTypeIdBei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Öffentliche EigenschaftValueRuft den Standardwert für die Anwendungseinstellungseigenschaft ab.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEqualsInfrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
Öffentliche MethodeGetHashCodeGibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsDefaultAttributeBeim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
Öffentliche MethodeMatchBeim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetIDsOfNamesOrdnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoRuft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoCountRuft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.InvokeStellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)
Zum Seitenanfang

Wichtiger HinweisWichtig

DefaultSettingValueAttribute kann nur auf einzelne Einstellungseigenschaften angewendet werden. Die Anwendung dieses Attributs auf eine ganze Anwendungseinstellungsklasse ist ungültig.

Andere Einstellungsanbieter haben möglicherweise andere Anforderungen oder Einschränkungen bei der Verwendung von DefaultSettingValueAttribute. Z. B. erfordert der LocalFileSettingsProvider dieses Attribut nicht und überschreibt alle von diesem Attribut bereitgestellten Werte, wenn bereits Standardwerte oder vom Benutzer veränderte Werte im Datenspeicher vorhanden sind.

DefaultSettingValueAttribute verlangt, dass der Standardwert als Zeichenfolge dargestellt werden kann. Einstellungen, die die XML-Serialisierung verwenden, können als Ergebnis keinen durch dieses Attribut angegebenen Standardwert haben. Einige Anbieter wählen möglicherweise, mehrere Serialisierungsschemas zu unterstützen, die zur Kompilierzeit mit dem SettingsSerializeAsAttribute angegeben werden können.

WarnhinweisVorsicht

Die von diesem Attribut angegebenen Standardwerte werden als unformatierter Text in der resultierenden kompilierten EXE- oder DLL-Datei gespeichert. Deshalb sind diese Standardwerte grundsätzlich unsicher.

Im folgenden Codebeispiel wird die Verwendung des DefaultSettingValueAttribute veranschaulicht, das auf drei der vier Eigenschaften der FormSettings-Wrapperklasse angewendet wird, die von der ApplicationSettingsBase-Klasse abgeleitet wird. Diese Klasse wird verwendet, um Speicherort, Größe, Hintergrundfarbe und Formulartext beizubehalten. Die ersten drei dieser Formulareigenschaften verfügen über ihnen zugeordnete Standardwerte.

Das vollständige Codebeispiel wird in der ApplicationSettingsBase-Klassenübersicht aufgelistet.


//Application settings wrapper class
sealed class FormSettings : ApplicationSettingsBase
{
    [UserScopedSettingAttribute()]
    public String FormText
    {
        get { return (String)this["FormText"]; }
        set { this["FormText"] = value; }
    }

    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("0, 0")]
    public Point FormLocation
    {
        get { return (Point)(this["FormLocation"]); }
        set { this["FormLocation"] = value; }
    }

    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("225, 200")]
    public Size FormSize
    {
        get { return (Size)this["FormSize"]; }
        set { this["FormSize"] = value; }
    }


    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("LightGray")]
    public Color FormBackColor
    {
        get { return (Color)this["FormBackColor"]; }
        set { this["FormBackColor"] = value; }
    }

}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft