Control.Tag Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origine:: Control.cs

Origine:: Control.cs

Origine:: Control.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta l'oggetto che contiene i dati sul controllo.

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object Tag { get; set; }

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object? Tag { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Tag : obj with get, set

Public Property Tag As Object

Valore della proprietà

Object

Oggetto Object che contiene i dati sul controllo. Il valore predefinito è null.

Attributi: BindableAttribute TypeConverterAttribute

Esempio

Nell'esempio di codice seguente viene visualizzato un modulo e viene archiviato un oggetto Customer nella relativa Tag proprietà. In questo esempio è necessario che sia stata definita una classe che deriva da Form denominata CustomerForm e che è stato definito un Customeroggetto .

private:
   void buttonNewCustomer_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      /* Create a new customer form and assign a new
                  * Customer object to the Tag property. */
      CustomerForm^ customerForm = gcnew CustomerForm;
      customerForm->Tag = gcnew Customer;
      customerForm->Show();
   }

private void buttonNewCustomer_Click(object sender, EventArgs e)
{
   /* Create a new customer form and assign a new 
    * Customer object to the Tag property. */
   CustomerForm customerForm = new CustomerForm();
   customerForm.Tag = new Customer();
   customerForm.Show();
}

Private Sub buttonNewCustomer_Click(sender As Object, _
  e As EventArgs) Handles buttonNewCustomer.Click
   ' Create a new customer form and assign a new 
   ' Customer object to the Tag property. 
   Dim customerForm As New CustomerForm()
   customerForm.Tag = New Customer()
   customerForm.Show()
End Sub

Commenti

Qualsiasi tipo derivato dalla Object classe può essere assegnato a questa proprietà. Se la proprietà è impostata tramite la Tag finestra di progettazione Windows Forms, è possibile assegnare solo testo.

Un uso comune per la proprietà consiste nell'archiviare Tag i dati strettamente associati al controllo. Ad esempio, se si dispone di un controllo che visualizza informazioni su un cliente, è possibile archiviare un DataSet oggetto contenente la cronologia degli ordini del cliente nella proprietà del Tag controllo in modo che i dati possano essere accessibili rapidamente.

Si applica a

Prodotto	Versioni
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Vedi anche

Object

Condividi tramite