HtmlTable.HtmlTableRowControlCollection.Add メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

HtmlTable.HtmlTableRowControlCollection.Add メソッド

指定した Control オブジェクトをコレクションに追加します。

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

Visual Basic (宣言)

Public Overrides Sub Add
 ( _
    child As Control _
)

Visual Basic (使用法)

Dim instance As HtmlTableRowControlCollection
Dim child As Control

instance.Add(child)

public override void Add (
    Control child
)

C++

public:
virtual void Add (
    Control^ child
) override

public void Add (
    Control child
)

JScript

public override function Add (
    child : Control
)

パラメータ

child: コレクションに追加する Control。

例外

例外の種類	条件
ArgumentException	追加されるコントロールは、型 HtmlTableRow のコントロールである必要があります。

解説

追加できるコントロールは、HtmlTableRow コントロールのみです。それ以外の場合は ArgumentException という例外がスローされます。

使用例

Add メソッドをオーバーライドするカスタム HtmlTable.HtmlTableRowControlCollection コレクションを作成し、テーブルに行を追加した場合にその行が必ずテーブルの行コレクションの先頭に追加されるようにする方法を次のコード例に示します。Add カスタムメソッドが、index パラメータが 0 に設定されている、基本クラスの AddAt メソッドを呼び出す方法に注意してください。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page Language="VB" AutoEventWireup="True"
 %>
<html>
  <head>
    <title>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</title>
  </head>
  <body>
    <form id="Form1" 
          method="post" 
          runat="server">
      <h3>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</h3>
      
      <aspSample:CustomHtmlTableRowControlCollection 
        id="HtmlTable1" 
        name="HtmlTable1" 
        runat="server" 
        border="1"
        cellSpacing="0" 
        cellPadding="5">
        <TR>
          <TD>1,1</TD>
          <TD>1,2</TD>
          <TD>1,3</TD>
        </TR>
        <TR>
          <TD>2,1</TD>
          <TD>2,2</TD>
          <TD>2,3</TD>
        </TR>
        <TR>
          <TD>3,1</TD>
          <TD>3,2</TD>
          <TD>3,3</TD>
        </TR>
      </aspSample:CustomHtmlTableRowControlCollection>

    </form>

  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls"
 Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
  <head>
    <title>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</title>
  </head>
  <body>
    <form id="Form1" 
          method="post" 
          runat="server">
      <h3>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</h3>
      
      <aspSample:CustomHtmlTableRowControlCollection 
        id="HtmlTable1" 
        name="HtmlTable1" 
        runat="server" 
        border="1"
        cellSpacing="0" 
        cellPadding="5">
        <TR>
          <TD>1,1</TD>
          <TD>1,2</TD>
          <TD>1,3</TD>
        </TR>
        <TR>
          <TD>2,1</TD>
          <TD>2,2</TD>
          <TD>2,3</TD>
        </TR>
        <TR>
          <TD>3,1</TD>
          <TD>3,2</TD>
          <TD>3,3</TD>
        </TR>
      </aspSample:CustomHtmlTableRowControlCollection>

    </form>

  </body>
</html>

Visual Basic

Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)>
 _
    Public NotInheritable Class
 CustomHtmlTableRowControlCollection
        Inherits System.Web.UI.HtmlControls.HtmlTable

        Protected Overrides Function
 CreateControlCollection() As System.Web.UI.ControlCollection

            Return New MyHtmlTableRowControlCollection(Me)

        End Function

        Protected Class MyHtmlTableRowControlCollection
            Inherits ControlCollection

            Friend Sub New(ByVal
 owner As Control)

                MyBase.New(owner)

            End Sub

            Public Overrides Sub
 Add(ByVal child As Control)

                ' Always add new rows at the top of the table.
                MyBase.AddAt(0, child)

            End Sub

        End Class

    End Class

End Namespace

using System.Web;
using System.Web.UI;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public class CustomHtmlTableRowControlCollection
 : System.Web.UI.HtmlControls.HtmlTable
    {

       protected override ControlCollection CreateControlCollection()
       {

         return new MyHtmlTableRowControlCollection(this);

       }

       protected class MyHtmlTableRowControlCollection
 : ControlCollection
       {

         internal MyHtmlTableRowControlCollection(Control owner) : base(owner)
 { }

         public override void Add(Control child)
         {

           // Always add new rows at the top of the table.
           base.AddAt(0, child);
         }

       }

    }

}