DataGridViewRow

.NET Framework クラス ライブラリ リファレンス

DataGridViewRow クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView コントロールの行を表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class DataGridViewRow
    Inherits DataGridViewBand

Visual Basic (使用法)

Dim instance As DataGridViewRow

C#

public class DataGridViewRow : DataGridViewBand

C++

public ref class DataGridViewRow : public
 DataGridViewBand

J#

public class DataGridViewRow extends DataGridViewBand

JScript

public class DataGridViewRow extends
 DataGridViewBand

解説

DataGridViewRow クラスは DataGridView コントロールの行を表します。行を取得するには、コントロールの Rows コレクションと SelectedRows コレクションを使用します。

DataGridViewColumn とは異なり、DataGridViewRow には行内のセルすべてのコレクションが物理的に格納されています。このコレクションにアクセスするには、Cells プロパティを使用します。

DataGridViewRow クラスは、個々のセル要素へのアクセスのほか、行の高さやセル スタイルなど、行のユーザー インターフェイス (UI) の外観と動作を調整するために使用されます。通常、コントロール内のすべての行、またはほとんどの行で同じ特性が共有されるようにします。コントロール内のすべての行にセル スタイルを設定するには、DataGridView.RowsDefaultCellStyle プロパティによって返されるオブジェクトのプロパティを設定します。交互の行にスタイルを設定するには、DataGridView.AlternatingRowsDefaultCellStyle プロパティを使用します。セル スタイルの詳細については、「Windows フォーム DataGridView コントロールでのセルのスタイル」を参照してください。DataGridView.RowTemplate プロパティを使用して、コントロールに追加されるすべての行の基礎として使用される行を定義することもできます。

DataGridView コントロールでは、パフォーマンスの低下を回避できる場合、複数のデータ行にわたって DataGridViewRow オブジェクトが共有されます。大量のデータを扱う場合やパフォーマンスの問題が発生している場合を除き、通常は行の共有を無視できます。共有行は、Index プロパティの値 -1 で示されます。DataGridViewRow クラスの一部のメンバは、共有行では使用できませんが、DataGridViewRowCollection.Item プロパティ経由で行にアクセスすることで、その行の共有を解除できます。別の方法で行の共有を解除することもできます。共有を解除せずに行にアクセスするには、DataGridViewRowCollection.SharedRow メソッドを使用します。大量のデータを扱う場合は、パフォーマンスの低下を回避するため、行の共有と共有解除がどのように行われるのかを知っておく必要があります。詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

継承時の注意 DataGridViewRow からクラスを派生させて新しいプロパティを追加する場合は、Clone メソッドをオーバーライドして、クローン操作時に新しいプロパティをコピーする必要があります。また、基本クラスの Clone メソッドも呼び出して、基本クラスのプロパティが新しいセルにコピーされるようにする必要があります。

使用例

この型の使用方法を次のコード例に示します。次の例は「方法 : Windows フォームの DataGridView コントロールの行を操作する」で取り上げている例の一部です。

Visual Basic

' 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

C#

// 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);
}

継承階層

System.Object
   System.Windows.Forms.DataGridViewElement
     System.Windows.Forms.DataGridViewBand
      System.Windows.Forms.DataGridViewRow

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRow メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス
Clone
その他の技術情報
Windows フォーム DataGridView コントロールを拡張するための推奨される手順
Windows フォーム DataGridView コントロールでのセルのスタイル

DataGridViewRow コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

テンプレートを使用せずに、DataGridViewRow クラスの新しいインスタンスを初期化します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DataGridViewRow

C#

public DataGridViewRow ()

C++

public:
DataGridViewRow ()

J#

public DataGridViewRow ()

JScript

public function DataGridViewRow ()

解説

このコンストラクタは、行を空白の状態に初期化します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRow クラス
DataGridViewRow メンバ
System.Windows.Forms 名前空間
DataGridView クラス

DataGridViewRow プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AccessibilityObject	DataGridViewRow に割り当てられた DataGridViewRow.DataGridViewRowAccessibleObject を取得します。
	Cells	行に設定されるセルのコレクションを取得します。
	ContextMenuStrip	オーバーライドされます。 行のショートカット メニューを取得または設定します。
	DataBoundItem	行に値を読み込むデータ バインド オブジェクトを取得します。
	DataGridView	この要素に関連付けられている DataGridView コントロールを取得します。 ( DataGridViewElement から継承されます。)
	DefaultCellStyle	オーバーライドされます。 スタイルがオーバーライドされない限り、行内のセルを描画する際に使用される、行の既定のスタイルを取得または設定します。
	DefaultHeaderCellType	既定のヘッダー セルのランタイム型を取得または設定します。 ( DataGridViewBand から継承されます。)
	Displayed	オーバーライドされます。 この行が画面上に表示されるかどうかを示す値を取得または設定します。
	DividerHeight	行の区分線の高さをピクセル単位で取得または設定します。
	ErrorText	行レベルのエラーのエラー メッセージ テキストを取得または設定します。
	Frozen	オーバーライドされます。 行が固定された状態かどうかを示す値を取得または設定します。
	HasDefaultCellStyle	DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。 ( DataGridViewBand から継承されます。)
	HeaderCell	行のヘッダー セルを取得または設定します。
	Height	行の現在の高さを取得または設定します。
	Index	DataGridView コントロール内のバンドの相対位置を取得します。 ( DataGridViewBand から継承されます。)
	InheritedStyle	オーバーライドされます。 行に対して有効なセル スタイルを取得します。
	IsNewRow	行が新しいレコードの行かどうかを示す値を取得します。
	MinimumHeight	行の最小の高さを取得または設定します。
	ReadOnly	オーバーライドされます。 行が読み取り専用かどうかを示す値を取得または設定します。
	Resizable	オーバーライドされます。 ユーザーが行のサイズを変更できるかどうかを示す値、または動作が DataGridView.AllowUserToResizeRows プロパティから継承されることを示す値を取得または設定します。
	Selected	オーバーライドされます。 行が選択されているかどうかを示す値を取得または設定します。
	State	オーバーライドされます。 行の現在の状態を取得します。
	Tag	バンドに関連付けられているデータを含むオブジェクトを取得または設定します。 ( DataGridViewBand から継承されます。)
	Visible	オーバーライドされます。 行を表示するかどうかを示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	HeaderCellCore	DataGridViewBand のヘッダー セルを取得または設定します。 ( DataGridViewBand から継承されます。)
	IsRow	バンドが行を表すかどうかを示す値を取得します。 ( DataGridViewBand から継承されます。)

参照

関連項目

DataGridViewRow クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス
Clone

その他の技術情報

Windows フォーム DataGridView コントロールを拡張するための推奨される手順
Windows フォーム DataGridView コントロールでのセルのスタイル

DataGridViewRow メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AdjustRowHeaderBorderStyle	指定した条件に従って、入力行ヘッダー境界線スタイルを変更します。
	Clone	オーバーライドされます。 この行の同一コピーを作成します。
	CreateCells	オーバーロードされます。 行内のセルをリセットします。
	Dispose	オーバーロードされます。 DataGridViewBand によって使用されているすべてのリソースを解放します。 ( DataGridViewBand から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetContextMenuStrip	行のショートカット メニューを取得します。
	GetErrorText	指定したインデックス位置の行のエラー テキストを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetPreferredHeight	指定した基準に基づいて、指定した行の適切な高さを計算します。
	GetState	行の現在の状態を示す値を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetValues	行のセルの値を設定します。
	ToString	オーバーライドされます。 行を説明する文字列をユーザーが判読できる形式で取得します。

プロテクト メソッド

	名前	説明
	CreateAccessibilityInstance	DataGridViewRow の新しいユーザー補助オブジェクトを作成します。
	CreateCellsInstance	この行に基づいて、セルの新しいコレクションを構築します。
	Dispose	オーバーロードされます。 DataGridViewBand によって使用されているすべてのリソースを解放します。 ( DataGridViewBand から継承されます。)
	DrawFocus	指定した境界の周囲に、フォーカスを表す四角形を描画します。
	Finalize	バンドに関連付けられたリソースを解放します。 ( DataGridViewBand から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnDataGridViewChanged	バンドが別の DataGridView に関連付けられている場合に呼び出されます。 ( DataGridViewBand から継承されます。)
	Paint	現在の行を描画します。
	PaintCells	現在の行内のセルを描画します。
	PaintHeader	現在の行のヘッダー セルを描画します。
	RaiseCellClick	DataGridView.CellClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellContentClick	DataGridView.CellContentClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellContentDoubleClick	DataGridView.CellContentDoubleClick イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseCellValueChanged	DataGridView.CellValueChanged イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseDataError	DataGridView.DataError イベントを発生させます。 ( DataGridViewElement から継承されます。)
	RaiseMouseWheel	Control.MouseWheel イベントを発生させます。 ( DataGridViewElement から継承されます。)

参照

関連項目

DataGridViewRow クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス
Clone

その他の技術情報

Windows フォーム DataGridView コントロールを拡張するための推奨される手順
Windows フォーム DataGridView コントロールでのセルのスタイル

DataGridViewRow メンバ

DataGridView コントロールの行を表します。

DataGridViewRow データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DataGridViewRow	テンプレートを使用せずに、DataGridViewRow クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AccessibilityObject	DataGridViewRow に割り当てられた DataGridViewRow.DataGridViewRowAccessibleObject を取得します。
	Cells	行に設定されるセルのコレクションを取得します。
	ContextMenuStrip	オーバーライドされます。 行のショートカット メニューを取得または設定します。
	DataBoundItem	行に値を読み込むデータ バインド オブジェクトを取得します。
	DataGridView	この要素に関連付けられている DataGridView コントロールを取得します。(DataGridViewElement から継承されます。)
	DefaultCellStyle	オーバーライドされます。 スタイルがオーバーライドされない限り、行内のセルを描画する際に使用される、行の既定のスタイルを取得または設定します。
	DefaultHeaderCellType	既定のヘッダー セルのランタイム型を取得または設定します。(DataGridViewBand から継承されます。)
	Displayed	オーバーライドされます。 この行が画面上に表示されるかどうかを示す値を取得または設定します。
	DividerHeight	行の区分線の高さをピクセル単位で取得または設定します。
	ErrorText	行レベルのエラーのエラー メッセージ テキストを取得または設定します。
	Frozen	オーバーライドされます。 行が固定された状態かどうかを示す値を取得または設定します。
	HasDefaultCellStyle	DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。 (DataGridViewBand から継承されます。)
	HeaderCell	行のヘッダー セルを取得または設定します。
	Height	行の現在の高さを取得または設定します。
	Index	DataGridView コントロール内のバンドの相対位置を取得します。(DataGridViewBand から継承されます。)
	InheritedStyle	オーバーライドされます。 行に対して有効なセル スタイルを取得します。
	IsNewRow	行が新しいレコードの行かどうかを示す値を取得します。
	MinimumHeight	行の最小の高さを取得または設定します。
	ReadOnly	オーバーライドされます。 行が読み取り専用かどうかを示す値を取得または設定します。
	Resizable	オーバーライドされます。 ユーザーが行のサイズを変更できるかどうかを示す値、または動作が DataGridView.AllowUserToResizeRows プロパティから継承されることを示す値を取得または設定します。
	Selected	オーバーライドされます。 行が選択されているかどうかを示す値を取得または設定します。
	State	オーバーライドされます。 行の現在の状態を取得します。
	Tag	バンドに関連付けられているデータを含むオブジェクトを取得または設定します。(DataGridViewBand から継承されます。)
	Visible	オーバーライドされます。 行を表示するかどうかを示す値を取得または設定します。

プロテクト プロパティ

	名前	説明
	HeaderCellCore	DataGridViewBand のヘッダー セルを取得または設定します。(DataGridViewBand から継承されます。)
	IsRow	バンドが行を表すかどうかを示す値を取得します。(DataGridViewBand から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AdjustRowHeaderBorderStyle	指定した条件に従って、入力行ヘッダー境界線スタイルを変更します。
	Clone	オーバーライドされます。 この行の同一コピーを作成します。
	CreateCells	オーバーロードされます。 行内のセルをリセットします。
	Dispose	オーバーロードされます。 DataGridViewBand によって使用されているすべてのリソースを解放します。 (DataGridViewBand から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetContextMenuStrip	行のショートカット メニューを取得します。
	GetErrorText	指定したインデックス位置の行のエラー テキストを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetPreferredHeight	指定した基準に基づいて、指定した行の適切な高さを計算します。
	GetState	行の現在の状態を示す値を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetValues	行のセルの値を設定します。
	ToString	オーバーライドされます。 行を説明する文字列をユーザーが判読できる形式で取得します。

プロテクト メソッド

	名前	説明
	CreateAccessibilityInstance	DataGridViewRow の新しいユーザー補助オブジェクトを作成します。
	CreateCellsInstance	この行に基づいて、セルの新しいコレクションを構築します。
	Dispose	オーバーロードされます。 DataGridViewBand によって使用されているすべてのリソースを解放します。 (DataGridViewBand から継承されます。)
	DrawFocus	指定した境界の周囲に、フォーカスを表す四角形を描画します。
	Finalize	バンドに関連付けられたリソースを解放します。 (DataGridViewBand から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnDataGridViewChanged	バンドが別の DataGridView に関連付けられている場合に呼び出されます。 (DataGridViewBand から継承されます。)
	Paint	現在の行を描画します。
	PaintCells	現在の行内のセルを描画します。
	PaintHeader	現在の行のヘッダー セルを描画します。
	RaiseCellClick	DataGridView.CellClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellContentClick	DataGridView.CellContentClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellContentDoubleClick	DataGridView.CellContentDoubleClick イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseCellValueChanged	DataGridView.CellValueChanged イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseDataError	DataGridView.DataError イベントを発生させます。 (DataGridViewElement から継承されます。)
	RaiseMouseWheel	Control.MouseWheel イベントを発生させます。 (DataGridViewElement から継承されます。)

参照

関連項目

DataGridViewRow クラス
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス
Clone

その他の技術情報

Windows フォーム DataGridView コントロールを拡張するための推奨される手順
Windows フォーム DataGridView コントロールでのセルのスタイル