RecommendedAsConfigurableAttribute RecommendedAsConfigurableAttribute RecommendedAsConfigurableAttribute RecommendedAsConfigurableAttribute Class

Definizione

Avviso

Questa API è ora obsoleta.

Consente di specificare che la proprietà può essere utilizzata come un'impostazione dell'applicazione.Specifies that the property can be used as an application setting.

public ref class RecommendedAsConfigurableAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Property)]
[System.Obsolete("Use System.ComponentModel.SettingsBindableAttribute instead to work with the new settings model.")]
public class RecommendedAsConfigurableAttribute : Attribute
type RecommendedAsConfigurableAttribute = class
    inherit Attribute
Public Class RecommendedAsConfigurableAttribute
Inherits Attribute
Ereditarietà
RecommendedAsConfigurableAttributeRecommendedAsConfigurableAttributeRecommendedAsConfigurableAttributeRecommendedAsConfigurableAttribute
Attributi

Esempi

Nell'esempio seguente una proprietà viene contrassegnata come utilizzabile come un'impostazione dell'applicazione.The following example marks a property as usable as an application setting.

public:
   [RecommendedAsConfigurable(true)]
   property int MyProperty 
   {
      int get()
      {
         // Insert code here.
         return 0;
      }
      void set( int /*value*/ )
      {
         // Insert code here.
      }
   }
[RecommendedAsConfigurable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }
<RecommendedAsConfigurable(True)> _
Public Property MyProperty() As Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

L'esempio seguente viene illustrato come controllare il valore della RecommendedAsConfigurableAttribute per MyProperty.The next example shows how to check the value of the RecommendedAsConfigurableAttribute for MyProperty. Prima di tutto il codice ottiene un PropertyDescriptorCollection con tutte le proprietà per l'oggetto.First the code gets a PropertyDescriptorCollection with all the properties for the object. Quindi l'indicizzazione nel PropertyDescriptorCollection per ottenere MyProperty.Next it indexes into the PropertyDescriptorCollection to get MyProperty. Quindi restituisce gli attributi per questa proprietà e li salva nella variabile di attributi.Then it returns the attributes for this property and saves them in the attributes variable.

In questo esempio presenta due modalità diverse di controllando il valore della RecommendedAsConfigurableAttribute.This example presents two different ways of checking the value of the RecommendedAsConfigurableAttribute. In questo secondo frammento di codice, nell'esempio viene chiamato il Equals (metodo).In the second code fragment, the example calls the Equals method. Nel frammento di codice ultimo, nell'esempio viene usato il RecommendedAsConfigurable proprietà per controllare il valore.In the last code fragment, the example uses the RecommendedAsConfigurable property to check the value.

// 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[ RecommendedAsConfigurableAttribute::typeid ]->Equals( RecommendedAsConfigurableAttribute::Yes ) )
{
   // Insert code here.
}

// This is another way to see if the property is recommended as configurable.
RecommendedAsConfigurableAttribute^ myAttribute = dynamic_cast<RecommendedAsConfigurableAttribute^>(attributes[ RecommendedAsConfigurableAttribute::typeid ]);
if ( myAttribute->RecommendedAsConfigurable )
{
   // Insert code here.
}
// 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.
}
' Gets the attributes for the property.
Dim attributes As AttributeCollection = TypeDescriptor.GetProperties(Me)("MyProperty").Attributes

' Checks to see if the value of the RecommendedAsConfigurableAttribute is Yes.
If attributes(GetType(RecommendedAsConfigurableAttribute)).Equals(RecommendedAsConfigurableAttribute.Yes) Then
    ' Insert code here.
End If 

' This is another way to see if the property is recommended as configurable.
Dim myAttribute As RecommendedAsConfigurableAttribute = _
    CType(attributes(GetType(RecommendedAsConfigurableAttribute)), RecommendedAsConfigurableAttribute)
If myAttribute.RecommendedAsConfigurable Then
    ' Insert code here.
End If

Se una classe contrassegnata con il RecommendedAsConfigurableAttribute, usare il codice seguente per controllare il valore.If you marked a class with the RecommendedAsConfigurableAttribute, use the following code to check the value.

AttributeCollection^ attributes = TypeDescriptor::GetAttributes( MyProperty );
if ( attributes[ RecommendedAsConfigurableAttribute::typeid ]->Equals( RecommendedAsConfigurableAttribute::Yes ) )
{
   // Insert code here.
}
AttributeCollection attributes = 
   TypeDescriptor.GetAttributes(MyProperty);
if(attributes[typeof(RecommendedAsConfigurableAttribute)].Equals(RecommendedAsConfigurableAttribute.Yes)) {
   // Insert code here.
}
Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(MyProperty)
If attributes(GetType(RecommendedAsConfigurableAttribute)).Equals(RecommendedAsConfigurableAttribute.Yes) Then
    ' Insert code here.
End If 

Commenti

Le proprietà contrassegnate con il RecommendedAsConfigurableAttribute impostata su true vengono visualizzate quando espande il ConfigurableProperties riga nel proprietà finestra.Properties that are marked with the RecommendedAsConfigurableAttribute set to true display when you expand the ConfigurableProperties line in the Properties window. Una proprietà priva di impostazioni consigliate o che sia contrassegnata con RecommendedAsConfigurableAttribute impostato su false non viene visualizzata e probabilmente non può essere un'impostazione dell'applicazione.A property that has no recommended setting or that is marked with RecommendedAsConfigurableAttribute set to false is not shown and is an unlikely candidate for being an application setting. Il valore predefinito è false.The default is false.

È possibile associare una proprietà che non è un RecommendedAsConfigurableAttribute a un'impostazione in Visual Studio facendo clic sul pulsante con puntini di sospensione (...) in impostazioni nel proprietà finestra e selezionando appropriato proprietà dall'elenco.You can bind a property that does not have a RecommendedAsConfigurableAttribute to a setting in Visual Studio by clicking the ellipsis button (…) under Settings in the Properties window and selecting the appropriate property from the list.

Nota

Quando si contrassegna una proprietà con RecommendedAsConfigurableAttribute impostata su true, il valore di questo attributo viene impostato sul membro costante Yes.When you mark a property with RecommendedAsConfigurableAttribute set to true, the value of this attribute is set to the constant member Yes. Per una proprietà contrassegnata con RecommendedAsConfigurableAttribute impostato su valore false, il valore è No.For a property marked with RecommendedAsConfigurableAttribute set to value false, the value is No. Pertanto, quando si desidera controllare il valore di questo attributo nel codice, è necessario specificare l'attributo come RecommendedAsConfigurableAttribute.Yes o RecommendedAsConfigurableAttribute.No.Therefore, when you want to check the value of this attribute in your code, you must specify the attribute as RecommendedAsConfigurableAttribute.Yes or RecommendedAsConfigurableAttribute.No.

Per altre informazioni, vedere Attributi.For more information, see Attributes.

..

Costruttori

RecommendedAsConfigurableAttribute(Boolean) RecommendedAsConfigurableAttribute(Boolean) RecommendedAsConfigurableAttribute(Boolean) RecommendedAsConfigurableAttribute(Boolean)

Inizializza una nuova istanza della classe RecommendedAsConfigurableAttribute.Initializes a new instance of the RecommendedAsConfigurableAttribute class.

Campi

Default Default Default Default

Consente di specificare il valore predefinito per l'attributo RecommendedAsConfigurableAttribute, che è No.Specifies the default value for the RecommendedAsConfigurableAttribute, which is No. Questo campo static è di sola lettura.This static field is read-only.

No No No No

Consente di specificare che una proprietà non può essere utilizzata come impostazione dell'applicazione.Specifies that a property cannot be used as an application setting. Questo campo static è di sola lettura.This static field is read-only.

Yes Yes Yes Yes

Consente di specificare che una proprietà può essere utilizzata come impostazione dell'applicazione.Specifies that a property can be used as an application setting. Questo campo static è di sola lettura.This static field is read-only.

Proprietà

RecommendedAsConfigurable RecommendedAsConfigurable RecommendedAsConfigurable RecommendedAsConfigurable

Ottiene un valore che indica se la proprietà alla quale è associato questo attributo può essere utilizzata come impostazione dell'applicazione.Gets a value indicating whether the property this attribute is bound to can be used as an application setting.

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Indica se questa istanza e un oggetto specificato sono uguali.Indicates whether this instance and a specified object are equal.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Indica se il valore dell'istanza è quello predefinito per la classe.Indicates whether the value of this instance is the default value for the class.

Match(Object) Match(Object) Match(Object) Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a

Vedi anche