DataGridViewRow クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataGridView コントロールの行を表します。
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 DataGridViewBandPublic Class DataGridViewRow
Inherits DataGridViewBand- 継承
- 属性
例
次のコード例は、この型の使用方法を示しています。 この例は、「方法: Windows フォーム DataGridView コントロールで行を操作する」で使用できるより大きな例の一部です。
// 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
注釈
このクラスは DataGridViewRow 、コントロール内の行を DataGridView 表します。 コントロールのコレクションをRowsSelectedRows通じて行を取得できます。
DataGridViewColumnとは異なり、DataGridViewRowその行内のすべてのセルのコレクションが物理的に含まれます。 このコレクションには、プロパティを Cells 使用してアクセスできます。
この DataGridViewRow クラスは、個々のセル要素にアクセスしたり、行のユーザー インターフェイス (UI) の外観や動作 (高さやセル のスタイルなど) を調整したりするために使用されます。 通常、コントロール内のすべての行またはほとんどの行が同じ特性を共有するようにします。 コントロール内のすべての行のセル スタイルを設定するには、プロパティによって返されるオブジェクトのプロパティを DataGridView.RowsDefaultCellStyle 設定します。 交互の行のスタイルを設定するには、プロパティを DataGridView.AlternatingRowsDefaultCellStyle 使用します。 セル スタイルの詳細については、「Windows フォーム DataGridView コントロールでのセルのスタイル」を参照してください。 また、このプロパティを DataGridView.RowTemplate 使用して、コントロールに追加されたすべての行の基準として使用される行を定義することもできます。
DataGridViewこのコントロールは、パフォーマンスの低下を避けるために、可能な限り複数のデータ行間でオブジェクトを共有DataGridViewRowします。 大量のデータを操作し、パフォーマンスの問題が発生している場合を除き、通常は行共有を無視できます。 共有行は、プロパティ値 -1 で Index 示されます。 クラスの一部の DataGridViewRow メンバーは共有行で使用できませんが、プロパティを介してアクセスすることで行の共有を DataGridViewRowCollection.Item[] 解除できます。 行は、他の方法で共有解除される場合もあります。 共有解除せずに行にアクセスするには、メソッドを使用します DataGridViewRowCollection.SharedRow 。 大量のデータを操作する場合は、パフォーマンスの低下を避けるために、行の共有方法と共有解除方法に注意する必要があります。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
注意 (継承者)
派生元 DataGridViewRow および派生クラスに新しいプロパティを追加する場合は、複製操作中に新しいプロパティを Clone() コピーするメソッドをオーバーライドしてください。 基底クラスの Clone() プロパティが新しいセルにコピーされるように、基底クラスのメソッドも呼び出す必要があります。
コンストラクター
| DataGridViewRow() |
テンプレートを使用せずに、DataGridViewRow クラスの新しいインスタンスを初期化します。 |
プロパティ
| AccessibilityObject |
DataGridViewRow.DataGridViewRowAccessibleObject に割り当てられた DataGridViewRow を取得します。 |
| Cells |
行に設定されるセルのコレクションを取得します。 |
| ContextMenuStrip |
行のショートカット メニューを取得または設定します。 |
| DataBoundItem |
行に値を読み込むデータ バインド オブジェクトを取得します。 |
| DataGridView |
この要素に関連付けられている DataGridView コントロールを取得します。 (継承元 DataGridViewElement) |
| DefaultCellStyle |
スタイルがオーバーライドされない限り、行内のセルを描画する際に使用される、行の既定のスタイルを取得または設定します。 |
| DefaultHeaderCellType |
既定のヘッダー セルのランタイム型を取得または設定します。 (継承元 DataGridViewBand) |
| Displayed |
この行が画面上に表示されるかどうかを示す値を取得または設定します。 |
| DividerHeight |
行の区分線の高さをピクセル単位で取得または設定します。 |
| ErrorText |
行レベルのエラーのエラー メッセージ テキストを取得または設定します。 |
| Frozen |
行が固定された状態かどうかを示す値を取得または設定します。 |
| HasDefaultCellStyle |
DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。 (継承元 DataGridViewBand) |
| HeaderCell |
行のヘッダー セルを取得または設定します。 |
| HeaderCellCore |
DataGridViewBand のヘッダー セルを取得または設定します。 (継承元 DataGridViewBand) |
| Height |
行の現在の高さを取得または設定します。 |
| Index |
DataGridView コントロール内のバンドの相対位置を取得します。 (継承元 DataGridViewBand) |
| InheritedStyle |
行に対して有効なセル スタイルを取得します。 |
| IsNewRow |
行が新しいレコードの行かどうかを示す値を取得します。 |
| IsRow |
バンドが行を表すかどうかを示す値を取得します。 (継承元 DataGridViewBand) |
| MinimumHeight |
行の最小の高さを取得または設定します。 |
| ReadOnly |
行が読み取り専用かどうかを示す値を取得または設定します。 |
| Resizable |
ユーザーが行のサイズを変更できるかどうかを示す値、または動作が AllowUserToResizeRows プロパティから継承されることを示す値を取得または設定します。 |
| Selected |
行が選択されているかどうかを示す値を取得または設定します。 |
| State |
行の現在の状態を取得します。 |
| Tag |
バンドに関連付けられているデータを含むオブジェクトを取得または設定します。 (継承元 DataGridViewBand) |
| Visible |
行を表示するかどうかを示す値を取得または設定します。 |