AttributeCollection.AddAttributes(HtmlTextWriter) メソッド

定義

属性をマークアップとして表示する AttributeCollection オブジェクトに HtmlTextWriter クラスの属性を追加します。

public:
 void AddAttributes(System::Web::UI::HtmlTextWriter ^ writer);
public void AddAttributes (System.Web.UI.HtmlTextWriter writer);
member this.AddAttributes : System.Web.UI.HtmlTextWriter -> unit
Public Sub AddAttributes (writer As HtmlTextWriter)

パラメーター

writer
HtmlTextWriter

ASP.NET サーバー コントロールの開始タグに属性を書き込む HtmlTextWriter インスタンス。

次の例は、名前付きのサーバー コントロールとサーバー コントロールにButtonmyButton新しい属性を追加する方法をTextBoxmyTextBox示しています。 次に、これらの属性をカスタム HtmlTextWriter オブジェクトに追加し、それらの各コントロールの出力ストリームにそれらの属性を書き込みます。

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

注釈

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

などのCalendarCheckBoxList他のコントロールに含まれているコントロールの場合は、含まれているコントロールを直接レンダリングすることでパフォーマンスを向上させることができます。 コンテナー コントロールでは、すべての子コントロール属性をコンテナー コントロールにコピーし、コピー後にレンダリングする必要があるため、コンテナー コントロールを介したレンダリングよりも直接レンダリングが高速になる場合があります。

適用対象

こちらもご覧ください