DataGridViewBand.Tag Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

DataGridViewBand.cs

Mendapatkan atau mengatur objek yang berisi data untuk dikaitkan dengan pita.

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

[System.ComponentModel.Browsable(false)]
public object? Tag { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Tag : obj with get, set

Public Property Tag As Object

Nilai Properti

Object

Yang Object berisi informasi yang terkait dengan band. Defaultnya adalah null.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut menggunakan Tag properti untuk menyimpan warna yang kemudian diambil untuk mengatur BackColor properti.

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

void SetBandColor( DataGridViewBand^ band, Color color )
{
   band->Tag = color;
}


// Color the bands by the value stored in their tag.
void Button9_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DataGridViewBand^ band = static_cast<DataGridViewBand^>(myEnum1->Current);
      if ( band->Tag != nullptr )
      {
         band->DefaultCellStyle->BackColor =  *dynamic_cast<Color^>(band->Tag);
      }
   }

   IEnumerator^ myEnum2 = safe_cast<IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      DataGridViewBand^ band = safe_cast<DataGridViewBand^>(myEnum2->Current);
      if ( band->Tag != nullptr )
      {
         band->DefaultCellStyle->BackColor =  *dynamic_cast<Color^>(band->Tag);
      }
   }
}

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;
        }
    }
}

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 band.Tag IsNot Nothing Then
            band.DefaultCellStyle.BackColor = _
                CType(band.Tag, Color)
        End If
    Next

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

Keterangan

Properti Tag dapat menyimpan objek apa pun yang ingin Anda kaitkan dengan pita. Properti ini biasanya digunakan untuk menyimpan informasi identifikasi, seperti nama string, pengidentifikasi unik (misalnya, Guid), atau indeks data pita dalam database.

Lihat juga

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• Guid