DataGridViewRow Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewRow.cs

Denetimdeki bir DataGridView satırı temsil eder.

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

Devralma

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Öznitelikler

TypeConverterAttribute

Örnekler

Aşağıdaki kod örneğinde bu türün kullanımı gösterilmektedir. Bu örnek, Nasıl yapılır: Windows Forms DataGridView Denetimindeki Satırları Değiştirme bölümünde bulunan daha büyük bir örneğin bir parçasıdır.

// 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

Açıklamalar

sınıfı denetimdeki DataGridViewRow bir DataGridView satırı temsil eder. Denetimin Rows ve SelectedRows koleksiyonları aracılığıyla satırları alabilirsiniz.

'nin DataGridViewColumnaksine, DataGridViewRow fiziksel olarak bu satırdaki tüm hücrelerin bir koleksiyonunu içerir. Bu koleksiyona Cells özelliği aracılığıyla erişebilirsiniz.

DataGridViewRow sınıfı, tek tek hücre öğelerine erişmek ve yükseklik ve hücre stili gibi satır kullanıcı arabiriminin (UI) görünümünü ve davranışını ayarlamak için kullanılır. Genellikle, denetimdeki tüm satırların veya çoğu satırın aynı özellikleri paylaşmasını istersiniz. Denetimdeki tüm satırların hücre stillerini ayarlamak için özelliği tarafından DataGridView.RowsDefaultCellStyle döndürülen nesnenin özelliklerini ayarlayın. Değişen satırların stillerini ayarlamak için özelliğini kullanın DataGridView.AlternatingRowsDefaultCellStyle . Hücre stilleri hakkında daha fazla bilgi için bkz. Windows Forms DataGridView Denetimindeki Hücre Stilleri. Denetimine DataGridView.RowTemplate eklenen tüm satırlar için temel olarak kullanılacak bir satır tanımlamak için özelliğini de kullanabilirsiniz.

Denetim, DataGridView performans cezalarını önlemek için mümkün olduğunda nesneleri birden çok veri satırı arasında paylaşır DataGridViewRow . Büyük miktarda veriyle çalışmadığınız ve performans sorunları yaşamadığınız sürece, genellikle satır paylaşımını yoksayabilirsiniz. Paylaşılan satır, -1 özellik değeriyle Index gösterilir. Sınıfın DataGridViewRow bazı üyeleri paylaşılan satırlarla kullanılamaz, ancak özelliği aracılığıyla erişerek bir satırın paylaşımını DataGridViewRowCollection.Item[] kaldırabilirsiniz. Satırlar başka yollarla paylaşılmayan hale de gelebilir. Satırın paylaşımını kaldırmadan erişmek için yöntemini kullanın DataGridViewRowCollection.SharedRow . Büyük miktarda veriyle çalışırken, performans cezalarını önlemek için satırların nasıl paylaşıldığını ve paylaşılmaması gerektiğini bilmeniz gerekir. Daha fazla bilgi için bkz. Windows Forms DataGridView Denetimini Ölçeklendirmeye yönelik En İyi Yöntemler.

Devralanlara Notlar

öğesinden DataGridViewRow türetdiğinizde ve türetilmiş sınıfa yeni özellikler eklediğinizde, kopyalama işlemleri sırasında yeni özellikleri kopyalamak için yöntemini geçersiz kıldığınızdan Clone() emin olun. Temel sınıfın Clone() özelliklerinin yeni hücreye kopyalanmaları için temel sınıfın yöntemini de çağırmalısınız.

Oluşturucular

Name	Description
DataGridViewRow()	Şablon kullanmadan sınıfının yeni bir örneğini DataGridViewRow başlatır.

Özellikler

Name	Description
AccessibilityObject	DataGridViewRow.DataGridViewRowAccessibleObject öğesine atananı DataGridViewRowalır.
Cells	Satırı dolduran hücre koleksiyonunu alır.
ContextMenuStrip	Satırın kısayol menüsünü alır veya ayarlar.
DataBoundItem	Satırı dolduran veriye bağlı nesneyi alır.
DataGridView	DataGridView Bu öğeyle ilişkili denetimi alır. (Devralındığı yer: DataGridViewElement)
DefaultCellStyle	Satır için varsayılan stilleri alır veya ayarlar; bu, stiller geçersiz kılınmadığı sürece satırdaki hücreleri işlemek için kullanılır.
DefaultHeaderCellType	Varsayılan üst bilgi hücresinin çalışma zamanı türünü alır veya ayarlar. (Devralındığı yer: DataGridViewBand)
Displayed	Bu satırın ekranda görüntülenip görüntülenmeyeceğini belirten bir değer alır.
DividerHeight	Satır ayırıcının yüksekliğini piksel cinsinden alır veya ayarlar.
ErrorText	Satır düzeyi hataları için hata iletisi metnini alır veya ayarlar.
Frozen	Satırın dondurulup donmadığını belirten bir değer alır veya ayarlar.
HasDefaultCellStyle	Özelliğin ayarlanıp ayarlanmadığını DefaultCellStyle belirten bir değer alır. (Devralındığı yer: DataGridViewBand)
HeaderCell	Satırın üst bilgi hücresini alır veya ayarlar.
HeaderCellCore	öğesinin üst bilgi hücresini DataGridViewBandalır veya ayarlar. (Devralındığı yer: DataGridViewBand)
Height	Satırın geçerli yüksekliğini alır veya ayarlar.
Index	Bandın denetim içindeki DataGridView göreli konumunu alır. (Devralındığı yer: DataGridViewBand)
InheritedStyle	Satır için geçerli hücre stilini alır.
IsNewRow	Satırın yeni kayıtların satırı olup olmadığını belirten bir değer alır.
IsRow	Bandın bir satırı temsil edip etmediğini gösteren bir değer alır. (Devralındığı yer: DataGridViewBand)
MinimumHeight	Satırın en düşük yüksekliğini alır veya ayarlar.
ReadOnly	Satırın salt okunur olup olmadığını belirten bir değer alır veya ayarlar.
Resizable	Kullanıcıların satırı yeniden boyutlandırıp boyutlandıramayacağını veya davranışın özelliğinden AllowUserToResizeRows devralındığını belirten bir değer alır veya ayarlar.
Selected	Satırın seçili olup olmadığını belirten bir değer alır veya ayarlar.
State	Satırın geçerli durumunu alır.
Tag	Bantla ilişkilendirilecek verileri içeren nesneyi alır veya ayarlar. (Devralındığı yer: DataGridViewBand)
Visible	Satırın görünür olup olmadığını belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Giriş satırı üst bilgisi kenarlık stilini belirtilen ölçütlere göre değiştirir.
Clone()	Bu satırın tam kopyasını oluşturur.
CreateAccessibilityInstance()	için DataGridViewRowyeni bir erişilebilir nesne oluşturur.
CreateCells(DataGridView, Object[])	Varolan hücreleri temizler ve bunların şablonlarını ve değerlerini ayarlar.
CreateCells(DataGridView)	Mevcut hücreleri temizler ve bunların şablonlarını sağlanan DataGridView şablona göre ayarlar.
CreateCellsInstance()	Bu satırı temel alan yeni bir hücre koleksiyonu oluşturur.
Dispose()	tarafından DataGridViewBandkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DataGridViewBand)
Dispose(Boolean)	tarafından DataGridViewBand kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Belirtilen sınırların etrafına bir odak dikdörtgeni çizer.
GetContextMenuStrip(Int32)	Satırın kısayol menüsünü alır.
GetErrorText(Int32)	Belirtilen dizindeki satır için hata metnini alır.
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Belirtilen ölçütlere göre belirtilen satırın ideal yüksekliğini hesaplar.
GetState(Int32)	Satırın geçerli durumunu gösteren bir değer döndürür.
OnDataGridViewChanged()	Bant farklı DataGridViewbir ile ilişkilendirildiğinde çağrılır. (Devralındığı yer: DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	Geçerli satırı boyar.
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Geçerli satırdaki hücreleri boyar.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Geçerli satırın üst bilgi hücresini boyar.
RaiseCellClick(DataGridViewCellEventArgs)	Olayı tetikler CellClick . (Devralındığı yer: DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Olayı tetikler CellContentClick . (Devralındığı yer: DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Olayı tetikler CellContentDoubleClick . (Devralındığı yer: DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Olayı tetikler CellValueChanged . (Devralındığı yer: DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Olayı tetikler DataError . (Devralındığı yer: DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Olayı tetikler MouseWheel . (Devralındığı yer: DataGridViewElement)
SetValues(Object[])	Satır hücrelerinin değerlerini ayarlar.
ToString()	Satırı açıklayan, okunabilir bir dize alır.

Ayrıca bkz.

• DataGridView
• DataGridViewColumn
• Clone()
• Windows Forms DataGridView Denetimini Ölçeklendirmek için En İyi Yöntemler
• Windows Forms DataGridView Denetimindeki Hücre Stilleri