Shape.Tag - свойство

Статья
11/01/2012

Возвращает или задает объект, содержащий данные об элементе управления линии и фигуры.

Пространство имен: Microsoft.VisualBasic.PowerPacks
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
<BrowsableAttribute(True)> _
Public Property Tag As Object

[BrowsableAttribute(true)]
public Object Tag { get; set; }

[BrowsableAttribute(true)]
public:
property Object^ Tag {
    Object^ get ();
    void set (Object^ value);
}

[<BrowsableAttribute(true)>]
member Tag : Object with get, set

function get Tag () : Object
function set Tag (value : Object)

Значение свойства

Тип: System.Object
Object содержит данные, связанные с элементом управления.Значение по умолчанию — нулевая ссылка (Nothing в Visual Basic).

Заметки

Данному свойству можно назначить любой тип, производный от класса Object.Если Tag свойство задается в конструкторе Windows Forms можно присвоить только текст.

Обычно свойство Tag применяется для хранения данных, связанных с элементом управления.Например, если имеется элемент управления, формы, представляющее объект в топографии сети, можно хранить a DataSet содержит сведения об этом объекте в Tag свойство поэтому данные можно быстро получить доступ.

Примеры

В следующем примере демонстрируется использование Tag свойство, чтобы передать экземпляр a NodeInfo класс в новой форме.В этом примере необходима a RectangleShape наблюдение за RectangleShape1 с именем в форме, то есть второй networkForm с именем формой, и вы определили a NodeInfo класс в проекте.

Private Sub Form1_Load() Handles MyBase.Load
    ' Declare an instance of a NodeInfo class.
    Dim MyNode As New NodeInfo
    ' Assign the instance to the Tag property.
    RectangleShape1.Tag = MyNode
End Sub

Private Sub RectangleShape1_Click() Handles RectangleShape1.Click
    ' Declare an instance of a networkForm form.
    Dim networkForm As New Form()
    ' Assign the Tag property of the RectangleShape to the new form.
    ' This passes the MyNode instance of the NodeInfo class to the
    ' form.
    networkForm.Tag = RectangleShape1.Tag
    ' Show the new form.
    networkForm.Show()
End Sub

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Declare an instance of a NodeInfo class.
    NodeInfo MyNode = new NodeInfo();
    // Assign the instance to the Tag property.
    rectangleShape1.Tag = MyNode;
}

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Declare an instance of a networkForm form.
    Form networkForm = new Form();
    // Assign the Tag property of the RectangleShape to the new form.
    // This passes the MyNode instance of the NodeInfo class to the
    // form.
    networkForm.Tag = rectangleShape1.Tag;
    // Show the new form.
    networkForm.Show();
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.