AttributeCollection.AddAttributes メソッド

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

AttributeCollection.AddAttributes メソッド

属性を HTML として ASP.NET サーバー コントロールに表示する HtmlTextWriter オブジェクトに AttributeCollection クラスの属性を追加します。

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

Visual Basic (宣言)

Public Sub AddAttributes ( _
    writer As HtmlTextWriter _
)

Visual Basic (使用法)

Dim instance As AttributeCollection
Dim writer As HtmlTextWriter

instance.AddAttributes(writer)

C#

public void AddAttributes (
    HtmlTextWriter writer
)

C++

public:
void AddAttributes (
    HtmlTextWriter^ writer
)

J#

public void AddAttributes (
    HtmlTextWriter writer
)

JScript

public function AddAttributes (
    writer : HtmlTextWriter
)

パラメータ

writer

追加された属性を ASP.NET サーバー コントロールの開始タグに書き込む HtmlTextWriter。

解説

このメソッドはサーバー コントロールのすべての属性を HtmlTextWriter オブジェクトにコピーし、次回の RenderBeginTag メソッドの呼び出しで表示されるようにします。

Calendar コントロールや CheckBoxList コントロールなどのサロゲート コントロールを直接表示すると、サロゲート コントロールに表示されるサーバー コントロールのパフォーマンスが向上する可能性があります。直接表示は、サロゲート コントロールを通じた表示よりも高速です。サロゲートでは、すべての子コントロール属性をサロゲートにコピーし、コピー時に 1 回表示する必要があるからです。

使用例

新しい属性を Button サーバー コントロール myButton と TextBox サーバー コントロール myTextBox に追加し、次にこれらの属性をカスタム HtmlTextWriter に追加し、これらの属性をコントロールの各出力ストリームに書き込む例を次に示します。

Visual Basic

myButton.Attributes.Clear()
myTextBox.Attributes.Clear()
myButton.Attributes("onClick") = "javascript:alert('Visiting
 msn.com');"

myTextBox.Attributes("name") = "MyTextBox"

myTextBox.Attributes("onBlur") = "javascript:alert('Leaving
 MyTextBox...');"

Dim myHttpResponse As HttpResponse = Response
Dim myHtmlTextWriter As New
 HtmlTextWriter(myHttpResponse.Output)

myButton.Attributes.AddAttributes(myHtmlTextWriter)
myTextBox.Attributes.AddAttributes(myHtmlTextWriter)

C#

myButton.Attributes.Clear();
myTextBox.Attributes.Clear();
myButton.Attributes["onClick"] = 
                "javascript:alert('Visiting msn.com');";

myTextBox.Attributes["name"] = "MyTextBox";

myTextBox.Attributes["onBlur"] = 
                 "javascript:alert('Leaving MyTextBox...');";
                           
HttpResponse myHttpResponse = Response;
HtmlTextWriter myHtmlTextWriter  = 
                 new HtmlTextWriter(myHttpResponse.Output);

myButton.Attributes.AddAttributes(myHtmlTextWriter);
myTextBox.Attributes.AddAttributes(myHtmlTextWriter);

J#

myButton.get_Attributes().Clear();
myTextBox.get_Attributes().Clear();
myButton.get_Attributes().set_Item("onClick", 
    "javascript:alert('Visiting msn.com');");

myTextBox.get_Attributes().set_Item("name","MyTextBox");

myTextBox.get_Attributes().set_Item("onBlur",
    "javascript:alert('Leaving MyTextBox...');");

HttpResponse myHttpResponse = get_Response();
HtmlTextWriter myHtmlTextWriter  = new HtmlTextWriter(myHttpResponse.
    get_Output());

myButton.get_Attributes().AddAttributes(myHtmlTextWriter);
myTextBox.get_Attributes().AddAttributes(myHtmlTextWriter);

プラットフォーム

Windows 98, Windows 2000 SP4, 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、1.1、1.0

参照

関連項目
AttributeCollection クラス
AttributeCollection メンバ
System.Web.UI 名前空間
RenderBeginTag