DataGridViewRow Sınıf
Tanım
Ö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
- Öznitelikler
Ö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. |