RowCount プロパティ (GcMultiRow)

GcMultiRowに表示される行数を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property RowCount As Integer

public int RowCount {get; set;}

プロパティ値

GcMultiRowに表示される行数を表すSystem.Int32値。

例外

例外	解説
System.InvalidOperationException	このプロパティを設定するとき、DataSourceプロパティが設定されています。またはこのプロパティを設定するとき、Templateプロパティがnull 参照 (Visual Basicでは Nothing)です。
System.ArgumentOutOfRangeException	このプロパティの設定時に指定された値が0未満です。または指定された値が1未満で、AllowUserToAddRowsがtrueに設定されています。

解説

System.InvalidOperationException

このプロパティを設定するとき、DataSourceプロパティが設定されています。

または

このプロパティを設定するとき、Templateプロパティがnull 参照 (Visual Basicでは Nothing)です。

System.ArgumentOutOfRangeException

このプロパティの設定時に指定された値が0未満です。

または

指定された値が1未満で、AllowUserToAddRowsがtrueに設定されています。

解説

UnboundモードおよびVirtualModeモードでは、RowCountが現在の行数より小さい値に設定されている場合、Rowsコレクションの末尾から行が削除されます。RowCountが現在の行数より大きい値に設定されている場合には、Rowsコレクションの末尾に行が追加されます。この追加行は、TemplateのTemplate.Rowプロパティで指定された行に基づきます。DataBindingモードでは、このプロパティは設定できません。

RowCountプロパティを0に設定すると、GcMultiRowからすべての行が削除されます。これはRowCollection.Clearメソッドを呼び出すのと同じです。AllowUserToAddRowsがtrueの場合はRowCountを0に設定できません。この場合、RowCollection.Clearメソッドを呼び出すと、新規レコード用の行を除くすべての行が削除されます。Clearを呼び出してもRowCountを1に設定しても結果は同じですが、前者の方が高速です。

参照

GcMultiRow クラス
 GcMultiRow メンバ