次の方法で共有


TableCellCollection.AddRange メソッド

指定した配列の TableCell オブジェクトをコレクションの末尾に追加します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
Public Sub AddRange ( _
    cells As TableCell() _
)
'使用
Dim instance As TableCellCollection
Dim cells As TableCell()

instance.AddRange(cells)
public void AddRange (
    TableCell[] cells
)
public:
void AddRange (
    array<TableCell^>^ cells
)
public void AddRange (
    TableCell[] cells
)
public function AddRange (
    cells : TableCell[]
)
適用できません。

パラメータ

  • cells
    コレクションに追加する TableCell オブジェクトを格納している配列。

例外

例外の種類 条件

ArgumentNullException

cells パラメータの値が null 参照 (Visual Basic では Nothing) です。

解説

AddRange メソッドを使用して、指定した配列の TableCell オブジェクトをコレクションに追加します。このメソッドは、通常、テーブルの行を構築しているときに使用します。テーブルの行を構築するには、最初に、行のセルを表すために TableCell オブジェクトの配列を作成します。次に、AddRange メソッドを使用し、引数としてこの配列を渡して、TableCell オブジェクトをコレクションに追加します。

使用例

AddRange メソッドを使用して、配列の TableCell オブジェクトを TableCellCollection に追加する方法の例を次に示します。この例では、TableRowCells プロパティは、TableCellCollection クラスのインスタンスです。

Sub Page_Load(ByVal sender As Object, _
    ByVal e As EventArgs)

    Dim numRows As Integer = 3
    Dim numCells As Integer = 2
    ' Create 3 rows, each containing 2 cells.
    Dim rowNum As Integer
    For rowNum = 0 To numRows - 1
        Dim arrayOfTableRowCells(numCells - 1) As TableCell
        Dim rw As New TableRow()
        Dim cellNum As Integer
        For cellNum = 0 To numCells - 1
            Dim cel As New TableCell()
            cel.Text = _
                String.Format("[Row {0}, Cell {1}]", rowNum, cellNum)
            arrayOfTableRowCells(cellNum) = cel
        Next

        ' Get 'TableCellCollection' associated with the 'TableRow'.
        Dim myTableCellCol As TableCellCollection = rw.Cells
        ' Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells)
        Table1.Rows.Add(rw)
    Next
End Sub
void Page_Load(Object sender, EventArgs e) 
{
    int numRows = 3;
    int numCells = 2;
    // Create 3 rows, each containing 2 cells.
    for(int rowNum = 0; rowNum < numRows; rowNum++) 
    {
        TableCell[] arrayOfTableRowCells = 
            new TableCell[numCells];
        TableRow tRow =  new TableRow();

        for (int cellNum = 0; cellNum < numCells; cellNum++)
        {
            TableCell tCell =  new TableCell();
            tCell.Text = 
                String.Format("[Row {0}, Cell {1}]", 
                    rowNum, cellNum);
            arrayOfTableRowCells[cellNum] = tCell;
        } 

        // Get 'TableCellCollection' associated 
        // with the 'TableRow'.
        TableCellCollection myTableCellCol = tRow.Cells;
        // Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells);
        Table1.Rows.Add(tRow);
    } 
}
void Page_Load(Object sender, EventArgs e) 
{
    int numRows = 3;
    int numCells = 2;
    // Create 3 rows, each containing 2 cells.
    for(int rowNum = 0; rowNum < numRows; rowNum++) 
    {
        TableCell[] arrayOfTableRowCells = 
            new TableCell[numCells];
        TableRow tRow =  new TableRow();

        for (int cellNum = 0; cellNum < numCells; cellNum++)
        {
            TableCell tCell =  new TableCell();
            tCell.set_Text("[Row " + rowNum + ", Cell " + cellNum + "]");
            arrayOfTableRowCells[cellNum] = tCell;
        } 

        // Get 'TableCellCollection' associated 
        // with the 'TableRow'.
        TableCellCollection myTableCellCol = tRow.get_Cells();
        // Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells);
        Table1.get_Rows().Add(tRow);
    } 
}

プラットフォーム

Windows 98,Windows Server 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

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

TableCellCollection クラス
TableCellCollection メンバ
System.Web.UI.WebControls 名前空間
Add
AddAt

その他の技術情報

Table、TableRow、TableCell の各 Web サーバー コントロール