Freigeben über


DataGridView.RowTemplate Eigenschaft

Definition

Ruft die Zeile ab, die die Vorlage für alle Zeilen im Steuerelement darstellt, oder legt sie fest.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set
Public Property RowTemplate As DataGridViewRow

Eigenschaftswert

DataGridViewRow

Eine DataGridViewRow, die die Zeilenvorlage darstellt.

Attribute

Ausnahmen

Für die beim Festlegen dieser Eigenschaft angegebene Zeile wurde die DataGridView-Eigenschaft festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Zeilenvorlage eine anfängliche Zeilenhöhe und eine Mindestzeilenhöhe angeben.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;
DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

Hinweise

Manchmal möchten Sie mehr Kontrolle über die Darstellung von DataGridView Zeilen als das, was von den verschiedenen DataGridView Zellenformateigenschaften bereitgestellt wird. Mit der RowTemplate Eigenschaft können Sie eine DataGridViewRow Vorlage für alle Zeilen erstellen und initialisieren, einschließlich der Zeile für neue Datensätze, falls AllowUserToAddRows vorhanden true.

Dies ist nützlich, wenn Sie Standardwerte für Eigenschaften wie Zeilenhöhe festlegen. Sie können beispielsweise die Standardzeilenhöhe erhöhen, um zusätzlichen Raum unter normalen Zellinhalten zum Anzeigen von Inhalten bereitzustellen, die mehrere Spalten umfassen.

Das Festlegen der Zeilenvorlage ist erforderlich, wenn externe Daten mithilfe benutzerdefinierter Typen angezeigt werden, die von der DataGridViewRow Klasse abgeleitet wurden. Mit ungebundenen DataGridView Steuerelementen können Sie die Rows Auflistung programmgesteuert mit Instanzen Ihres benutzerdefinierten Zeilentyps auffüllen. Beim Anzeigen externer Daten werden die Zeilen jedoch automatisch generiert, basieren jedoch auf der Zeilenvorlage, die Sie auf eine Instanz des benutzerdefinierten Zeilentyps festlegen können.

Wenn diese Eigenschaft beim ersten Abrufen des Werts nicht festgelegt wurde, wird ein neues DataGridViewRow erstellt und zurückgegeben.

Gilt für

Siehe auch