DataGridView.RowTemplate Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property RowTemplate As DataGridViewRowEigenschaftswert
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.