Control.Tag Proprietà
Definizione
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à
Oggetto Object che contiene i dati sul controllo. Il valore predefinito è null
.
- Attributi
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 Customer
oggetto .
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.