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

DefaultSettingValueAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Gibt den Standardwert für eine Anwendungseinstellungseigenschaft an.

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

System.Object
  System.Attribute
    System.Configuration.DefaultSettingValueAttribute

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

NameBeschreibung
System_CAPS_pubmethodDefaultSettingValueAttribute(String)

Initialisiert eine Instanz der DefaultSettingValueAttribute-Klasse.

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 den Standardwert für die Anwendungseinstellungseigenschaft ab.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

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“.)

System_CAPS_importantWichtig

DefaultSettingValueAttribute kann nur auf einzelne Einstellungseigenschaften angewendet werden. Es ist unzulässig, dieses Attribut auf eine gesamte Anwendung Settings-Klasse anwenden.

Verschiedene Einstellungsanbieter verfügt möglicherweise über unterschiedliche Anforderungen und Einschränkungen für die Verwendung von der DefaultSettingValueAttribute. Z. B. die LocalFileSettingsProvider erfordert dieses Attribut nicht und überschreibt alle von diesem Attribut bereitgestellt wird, wenn Werte vorhanden sind – Standard oder Benutzer geändert hat, im Datenspeicher bereits vorhanden.

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

System_CAPS_cautionAchtung

Die von diesem Attribut angegebenen Standardwerte werden als nur-Text in der resultierenden kompilierten .exe oder .dll-Datei gespeichert. Daher sind diese Standardwerte grundsätzlich unsicher.

Das folgende Codebeispiel veranschaulicht die Verwendung von der DefaultSettingValueAttribute angewendet auf drei der vier Eigenschaften von der FormSettings Wrapperklasse, die von abgeleitet ist der ApplicationSettingsBase Klasse. Diese Klasse wird verwendet, um den Speicherort, Größe, Hintergrundfarbe und Text der Form beizubehalten. Die ersten drei dieser Formulareigenschaften verfügen über Standardwerte, die ihnen zugeordneten.

Das vollständige Codebeispiel finden Sie in der ApplicationSettingsBase Übersicht über die Klasse.

//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
Verfügbar seit 2.0

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: