DataGridViewRow Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili baris dalam DataGridView kontrol.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand

Public Class DataGridViewRow
Inherits DataGridViewBand

Warisan: Object

DataGridViewElement

DataGridViewBand
DataGridViewRow

Atribut: TypeConverterAttribute

Contoh

Contoh kode berikut mengilustrasikan penggunaan jenis ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia di Cara: Memanipulasi Baris di kontrol Formulir Windows DataGridView.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}

// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}

' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

Keterangan

Kelas DataGridViewRow mewakili baris dalam DataGridView kontrol. Anda dapat mengambil baris melalui Rows koleksi kontrol dan SelectedRows .

DataGridViewColumnTidak seperti , DataGridViewRow secara fisik berisi kumpulan semua sel dalam baris tersebut. Anda dapat mengakses koleksi ini melalui Cells properti .

Kelas DataGridViewRow ini digunakan untuk mengakses elemen sel individual, serta untuk menyesuaikan tampilan dan perilaku antarmuka pengguna baris (UI), seperti tinggi dan gaya sel. Biasanya, Anda akan menginginkan semua baris atau sebagian besar baris dalam kontrol berbagi karakteristik yang sama. Untuk mengatur gaya sel untuk semua baris dalam kontrol, atur properti objek yang dikembalikan oleh DataGridView.RowsDefaultCellStyle properti . Untuk mengatur gaya untuk baris bergantian, gunakan DataGridView.AlternatingRowsDefaultCellStyle properti . Untuk informasi selengkapnya tentang gaya sel, lihat Gaya Sel di Formulir Windows Kontrol DataGridView. Anda juga dapat menggunakan DataGridView.RowTemplate properti untuk menentukan baris yang akan digunakan sebagai dasar untuk semua baris yang ditambahkan ke kontrol.

Kontrol DataGridView akan berbagi DataGridViewRow objek di beberapa baris data jika memungkinkan untuk menghindari penalti performa. Kecuali Anda bekerja dengan data dalam jumlah besar dan mengalami masalah performa, Anda biasanya dapat mengabaikan berbagi baris. Baris bersama ditunjukkan oleh Index nilai properti -1. Beberapa anggota DataGridViewRow kelas tidak dapat digunakan dengan baris bersama, tetapi Anda dapat membatalkan berbagi baris dengan mengaksesnya melalui DataGridViewRowCollection.Item[] properti . Baris juga bisa menjadi tidak dibagi dengan cara lain. Untuk mengakses baris tanpa membukanya, gunakan DataGridViewRowCollection.SharedRow metode . Saat bekerja dengan data dalam jumlah besar, Anda harus mengetahui bagaimana baris dibagikan dan tidak dibagikan untuk menghindari penalti performa. Untuk informasi selengkapnya, lihat Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView.

Catatan Bagi Inheritor

Ketika Anda berasal dari DataGridViewRow dan menambahkan properti baru ke kelas turunan, pastikan untuk mengambil alih Clone() metode untuk menyalin properti baru selama operasi kloning. Anda juga harus memanggil metode kelas Clone() dasar sehingga properti kelas dasar disalin ke sel baru.

Konstruktor

DataGridViewRow()

Menginisialisasi instans DataGridViewRow baru kelas tanpa menggunakan templat.

Properti

AccessibilityObject	Mendapatkan yang DataGridViewRow.DataGridViewRowAccessibleObject ditetapkan ke DataGridViewRow.
Cells	Mendapatkan kumpulan sel yang mengisi baris.
ContextMenuStrip	Mendapatkan atau mengatur menu pintasan untuk baris.
DataBoundItem	Mendapatkan objek terikat data yang mengisi baris.
DataGridView	Mendapatkan kontrol yang DataGridView terkait dengan elemen ini. (Diperoleh dari DataGridViewElement)
DefaultCellStyle	Mendapatkan atau mengatur gaya default untuk baris, yang digunakan untuk merender sel dalam baris kecuali gaya ditimpa.
DefaultHeaderCellType	Mendapatkan atau mengatur jenis run-time dari sel header default. (Diperoleh dari DataGridViewBand)
Displayed	Mendapatkan nilai yang menunjukkan apakah baris ini ditampilkan di layar.
DividerHeight	Mendapatkan atau mengatur tinggi, dalam piksel, dari pembagi baris.
ErrorText	Mendapatkan atau mengatur teks pesan kesalahan untuk kesalahan tingkat baris.
Frozen	Mendapatkan atau menetapkan nilai yang menunjukkan apakah baris dibekukan.
HasDefaultCellStyle	Mendapatkan nilai yang menunjukkan apakah DefaultCellStyle properti telah ditetapkan. (Diperoleh dari DataGridViewBand)
HeaderCell	Mendapatkan atau mengatur sel header baris.
HeaderCellCore	Mendapatkan atau mengatur sel header dari DataGridViewBand. (Diperoleh dari DataGridViewBand)
Height	Mendapatkan atau mengatur tinggi baris saat ini.
Index	Mendapatkan posisi relatif pita dalam DataGridView kontrol. (Diperoleh dari DataGridViewBand)
InheritedStyle	Mendapatkan gaya sel yang berlaku untuk baris.
IsNewRow	Mendapatkan nilai yang menunjukkan apakah baris adalah baris untuk rekaman baru.
IsRow	Mendapatkan nilai yang menunjukkan apakah pita mewakili baris. (Diperoleh dari DataGridViewBand)
MinimumHeight	Mendapatkan atau mengatur tinggi minimum baris.
ReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah baris bersifat baca-saja.
Resizable	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna dapat mengubah ukuran baris atau menunjukkan bahwa perilaku diwariskan dari AllowUserToResizeRows properti.
Selected	Mendapatkan atau menetapkan nilai yang menunjukkan apakah baris dipilih.
State	Mendapatkan status baris saat ini.
Tag	Mendapatkan atau mengatur objek yang berisi data untuk dikaitkan dengan pita. (Diperoleh dari DataGridViewBand)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah baris terlihat.

Metode

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Memodifikasi gaya batas header baris input sesuai dengan kriteria yang ditentukan.
Clone()	Membuat salinan yang tepat dari baris ini.
CreateAccessibilityInstance()	Membuat objek baru yang dapat diakses untuk DataGridViewRow.
CreateCells(DataGridView)	Menghapus sel yang ada dan mengatur templatnya sesuai dengan templat yang disediakan DataGridView .
CreateCells(DataGridView, Object[])	Menghapus sel yang ada dan mengatur templat dan nilainya.
CreateCellsInstance()	Membuat kumpulan sel baru berdasarkan baris ini.
Dispose()	Merilis semua sumber daya yang DataGridViewBanddigunakan oleh . (Diperoleh dari DataGridViewBand)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang DataGridViewBand digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Menggambar persegi panjang fokus di sekitar batas yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetContextMenuStrip(Int32)	Mendapatkan menu pintasan untuk baris.
GetErrorText(Int32)	Mendapatkan teks kesalahan untuk baris pada indeks yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Menghitung tinggi ideal baris yang ditentukan berdasarkan kriteria yang ditentukan.
GetState(Int32)	Mengembalikan nilai yang menunjukkan status baris saat ini.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnDataGridViewChanged()	Dipanggil ketika band dikaitkan dengan yang berbeda DataGridView. (Diperoleh dari DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	Melukis baris saat ini.
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Melukis sel dalam baris saat ini.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Melukis sel header dari baris saat ini.
RaiseCellClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellContentClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellContentDoubleClick. (Diperoleh dari DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Memunculkan kejadian CellValueChanged. (Diperoleh dari DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Memunculkan kejadian DataError. (Diperoleh dari DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Memunculkan kejadian MouseWheel. (Diperoleh dari DataGridViewElement)
SetValues(Object[])	Mengatur nilai sel baris.
ToString()	Mendapatkan string yang dapat dibaca manusia yang menjelaskan baris.

Berlaku untuk

Bagikan melalui