DataGridViewRow Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimdeki DataGridView bir 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ği, bu türün kullanımını gösterir. Bu örnek, Windows Forms DataGridView Denetimindeki Satırları Düzenleme bölümünde bulunan daha büyük bir örneğin 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.

bir DataGridViewColumn'in aksine, DataGridViewRow fiziksel olarak bu satırdaki tüm hücrelerin 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. Normalde, 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 miktarlarda 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 şekillerde paylaşılmayan satırlara da dönüşebilir. Satıra 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ığına ve paylaşılmayanlara dikkat etmeniz 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üretilen 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

DataGridViewRow()

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

Özellikler

AccessibilityObject	DataGridViewRow.DataGridViewRowAccessibleObject öğesine atanan öğesini 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; 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 bölücüsü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 hücre stilinin etkin olduğunu gösterir.
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

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Giriş satırı üst bilgi kenarlık stilini belirtilen ölçütlere göre değiştirir.
Clone()	Bu satırın tam bir kopyasını oluşturur.
CreateAccessibilityInstance()	için DataGridViewRowyeni bir erişilebilir nesne oluşturur.
CreateCells(DataGridView)	Varolan hücreleri temizler ve bunların şablonlarını sağlanan DataGridView şablona göre ayarlar.
CreateCells(DataGridView, Object[])	Varolan hücreleri temizler ve bunların şablonlarını ve değerlerini ayarlar.
CreateCellsInstance()	Bu satırı temel alan yeni bir hücre koleksiyonu oluşturur.
Dispose()	DataGridViewBand tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DataGridViewBand)
Dispose(Boolean)	DataGridViewBand tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak 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.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetContextMenuStrip(Int32)	Satırın kısayol menüsünü alır.
GetErrorText(Int32)	Belirtilen dizindeki satır için hata metnini alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
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.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
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.

Şunlara uygulanır