DataGridViewBand.Tag プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridViewBand.Tag プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

バンドに関連付けられているデータを含むオブジェクトを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Tag As Object

Visual Basic (使用法)

Dim instance As DataGridViewBand
Dim value As Object

value = instance.Tag

instance.Tag = value

public Object Tag { get; set;
 }

C++

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

/** @property */
public Object get_Tag ()

/** @property */
public void set_Tag (Object value)

JScript

public function get Tag
 () : Object

public function set Tag
 (value : Object)

プロパティ値
バンドに関連付けられた情報を含む Object。既定値は null 参照 (Visual Basic では Nothing) です。

解説

使用例

Tag プロパティを使用して色を格納し、これを取得して BackColor プロパティを設定するコード例を次に示します。

Visual Basic

Private Sub PostRowCreation()
    SetBandColor(dataGridView.Columns(0), Color.CadetBlue)
    SetBandColor(dataGridView.Rows(1), Color.Coral)
    SetBandColor(dataGridView.Columns(2), Color.DodgerBlue)
End Sub

Private Shared Sub SetBandColor(ByVal
 band As DataGridViewBand, _
    ByVal color As Color)
    band.Tag = color
End Sub

' Color the bands by the value stored in their tag.
Private Sub Button9_Click(ByVal
 sender As Object, _
    ByVal e As System.EventArgs) Handles
 Button9.Click

    For Each band As DataGridViewBand
 In dataGridView.Columns
        If Not band.Tag Is
 Nothing Then
            band.DefaultCellStyle.BackColor = _
                CType(band.Tag, Color)
        End If
    Next

    For Each band As DataGridViewBand
 In dataGridView.Rows
        If Not band.Tag Is
 Nothing Then
            band.DefaultCellStyle.BackColor = _
                CType(band.Tag, Color)
        End If
    Next
End Sub

private void PostRowCreation()
{
    SetBandColor(dataGridView.Columns[0], Color.CadetBlue);
    SetBandColor(dataGridView.Rows[1], Color.Coral);
    SetBandColor(dataGridView.Columns[2], Color.DodgerBlue);
}

private static void SetBandColor(DataGridViewBand
 band, Color color)
{
    band.Tag = color;
}

// Color the bands by the value stored in their tag.
private void Button9_Click(object sender, System.EventArgs
 e)
{

    foreach (DataGridViewBand band in dataGridView.Columns)
    {
        if (band.Tag != null)
        {
            band.DefaultCellStyle.BackColor = (Color)band.Tag;
        }
    }

    foreach (DataGridViewBand band in dataGridView.Rows)
    {
        if (band.Tag != null)
        {
            band.DefaultCellStyle.BackColor = (Color)band.Tag;
        }
    }
}