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

RecommendedAsConfigurableAttribute-Klasse

 

Veröffentlicht: Oktober 2016

obsoleteCodeEntityT:System.ComponentModel.SettingsBindableAttribute Hinweis: Diese API ist jetzt veraltet.

Gibt an, dass die Eigenschaft als anwendungseinstellung einer verwendet werden kann.

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

System.Object
  System.Attribute
    System.ComponentModel.RecommendedAsConfigurableAttribute

[AttributeUsageAttribute(AttributeTargets.Property)]
[ObsoleteAttribute("Use System.ComponentModel.SettingsBindableAttribute instead to work with the new settings model.")]
public class RecommendedAsConfigurableAttribute : Attribute

NameBeschreibung
System_CAPS_pubmethodRecommendedAsConfigurableAttribute(Boolean)

Initialisiert eine neue Instanz der RecommendedAsConfigurableAttribute-Klasse.

NameBeschreibung
System_CAPS_pubpropertyRecommendedAsConfigurable

Ruft einen Wert ab, der angibt, ob die Eigenschaft dieses Attribut gebunden ist als die anwendungseinstellung einer werden können.

System_CAPS_pubpropertyTypeId

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

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Gibt an, ob diese Instanz und ein angegebenes Objekt gleich sind.(Überschreibt Attribute.Equals(Object).)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „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 an, ob der Wert dieser Instanz der Standardwert für die Klasse.(Überschreibt Attribute.IsDefaultAttribute().)

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_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

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

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticDefault

Gibt den Standardwert für den RecommendedAsConfigurableAttribute, also No. Diese static Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticNo

Gibt an, dass eine Eigenschaft als die anwendungseinstellung einer verwendet werden kann. Diese static Feld ist schreibgeschützt.

System_CAPS_pubfieldSystem_CAPS_staticYes

Gibt an, dass eine Eigenschaft als die anwendungseinstellung einer verwendet werden kann. Diese static Feld ist schreibgeschützt.

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

Eigenschaften, die mit der RecommendedAsConfigurableAttribute festgelegt true anzuzeigen, erweitern Sie die ConfigurableProperties Zeile in der Eigenschaften Fenster. Eine Eigenschaft, bei dem keine empfohlene Einstellung oder markiert mit RecommendedAsConfigurableAttribute festgelegt false wird nicht angezeigt und ist ein unwahrscheinlich Kandidat für eine anwendungseinstellung wird. Die Standardeinstellung ist false.

Sie können eine Eigenschaft, die keinen Binden einer RecommendedAsConfigurableAttribute Einstellung in Visual Studio durch Klicken auf die Schaltfläche mit den Auslassungspunkten (...) Klicken Sie unter Einstellungen in der Eigenschaften Fenster und die entsprechende Eigenschaft aus der Liste auswählen.

System_CAPS_noteHinweis

Wenn Sie eine Eigenschaft mit markieren RecommendedAsConfigurableAttribute festgelegt true, wird der Wert dieses Attributs auf den Konstanten Member festgelegt Yes. Für eine Eigenschaft mit RecommendedAsConfigurableAttribute Wert false, der Wert ist No. Daher, wenn Sie den Wert dieses Attributs im Code überprüfen möchten, geben Sie das Attribut als RecommendedAsConfigurableAttribute.Yes oder RecommendedAsConfigurableAttribute.No.

Weitere Informationen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

.

Im folgenden Beispiel wird eine Eigenschaft als die anwendungseinstellung einer verwendbare markiert.

[RecommendedAsConfigurable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

Das nächste Beispiel zeigt, wie Sie den Wert überprüfen die RecommendedAsConfigurableAttribute für MyProperty. Zunächst wird ein PropertyDescriptorCollection mit allen Eigenschaften für das Objekt. Als Nächstes werden indiziert in der PropertyDescriptorCollection abzurufenden MyProperty. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Attributes-Variablen gespeichert.

In diesem Beispiel sind zwei verschiedene Arten der Überprüfung des Werts der der RecommendedAsConfigurableAttribute. Im zweiten Codefragment, das Beispiel ruft die Equals Methode. Im letzten Codefragment, das Beispiel verwendet die RecommendedAsConfigurable Eigenschaft, um den Wert zu überprüfen.

// Gets the attributes for the property.
AttributeCollection attributes = 
   TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

// Checks to see if the value of the RecommendedAsConfigurableAttribute is Yes.
if(attributes[typeof(RecommendedAsConfigurableAttribute)].Equals(RecommendedAsConfigurableAttribute.Yes)) {
   // Insert code here.
}

// This is another way to see if the property is recommended as configurable.
RecommendedAsConfigurableAttribute myAttribute = 
   (RecommendedAsConfigurableAttribute)attributes[typeof(RecommendedAsConfigurableAttribute)];
if(myAttribute.RecommendedAsConfigurable) {
   // Insert code here.
}

Wenn Sie eine Klasse mit markiert die RecommendedAsConfigurableAttribute, verwenden Sie den folgenden Code, um den Wert zu überprüfen.

AttributeCollection attributes = 
   TypeDescriptor.GetAttributes(MyProperty);
if(attributes[typeof(RecommendedAsConfigurableAttribute)].Equals(RecommendedAsConfigurableAttribute.Yes)) {
   // Insert code here.
}

.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: