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

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

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

ImageButton.AddAttributesToRender メソッド

ImageButton の属性を、クライアントに表示する出力ストリームに追加します。

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

Visual Basic (宣言)

Protected Overrides Sub
 AddAttributesToRender ( _
    writer As HtmlTextWriter _
)

Visual Basic (使用法)

Dim writer As HtmlTextWriter

Me.AddAttributesToRender(writer)

protected override void AddAttributesToRender
 (
    HtmlTextWriter writer
)

C++

protected:
virtual void AddAttributesToRender (
    HtmlTextWriter^ writer
) override

protected void AddAttributesToRender (
    HtmlTextWriter writer
)

JScript

protected override function AddAttributesToRender
 (
    writer : HtmlTextWriter
)

パラメータ

writer: クライアントで表示するための出力ストリーム。

解説

OnPreRender メソッドは、カスタムクラスを ImageButton コントロールから派生させる場合に、主に開発者によって使用されます。

使用例

カスタムサーバーコントロールの AddAttributesToRender メソッドをオーバーライドして、ImageButton のテキストに常に細い境界線を表示する方法のコード例を次に示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルの最初の部分は、拡張子が .aspx の空のテキストファイルにコピーする必要があります。2 番目の部分はコードファイル (C# の場合は .cs、Visual Basic の場合は .vb) として保存する必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルの最初の部分は、拡張子が .aspx の空のテキストファイルにコピーする必要があります。2 番目の部分はコードファイル (C# の場合は .cs、Visual Basic の場合は .vb) として保存する必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page Language="VB" AutoEventWireup="True"
 %>
<HTML>
    <HEAD>
        <title>Custom ImageButton - AddAttributesToRender - VB.NET Example</title>
        <script runat="server">
            Sub ImageButton1_Command(sender As
 Object, e As CommandEventArgs)
                ' Redirect to the Microsoft home page.
                Response.Redirect("http://www.microsoft.com/")
            End Sub
        </script>
    </HEAD>
    <body>
        <form id="Form1" method="post"
 runat="server">
            <h3>Custom ImageButton - AddAttributesToRender - VB.NET Example</h3>
            
            <aspSample:CustomImageButtonAddAttributesToRender id="ImageButton1"
 runat="server" 
             OnCommand="ImageButton1_Command" AlternateText="Microsoft
 Home" 
             ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif"
 />

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br
 />    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)>
 _
    Public NotInheritable Class
 CustomImageButtonAddAttributesToRender
        Inherits System.Web.UI.WebControls.ImageButton

        Protected Overrides Sub
 AddAttributesToRender(ByVal writer As System.Web.UI.HtmlTextWriter)

            ' Show the ImageButton with a thin border.
            writer.AddStyleAttribute("border-width",
 "thin")

            ' Call the Base's AddAttributesToRender method.
            MyBase.AddAttributesToRender(writer)
        End Sub
    End Class

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls"
 Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom ImageButton - AddAttributesToRender - C# Example</title>
    <script runat="server">
      void ImageButton1_Command(Object sender, CommandEventArgs
 e) 
      {
        // Redirect to the Microsoft home page.
        Response.Redirect("http://www.microsoft.com/");
      }
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom ImageButton - AddAttributesToRender - C# Example</h3>
            
            <aspSample:CustomImageButtonAddAttributesToRender id="ImageButton1"
 runat="server" 
             OnCommand="ImageButton1_Command" AlternateText="Microsoft
 Home" 
             ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif"
 />

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br />using
 System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomImageButtonAddAttributesToRender
 : System.Web.UI.WebControls.ImageButton
    {
        protected override void AddAttributesToRender(System.Web.UI.HtmlTextWriter
 writer)
        {
            // Show the ImageButton with a thin border.
            writer.AddStyleAttribute("border-width","thin");

            // Call the Base's AddAttributesToRender method.
            base.AddAttributesToRender(writer);
        }
    }
}

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls"
 Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom ImageButton - AddAttributesToRender - VJ# Example</title>
    <script runat="server">
        void ImageButton1_Command(Object sender, CommandEventArgs
 e) 
        {
            // Redirect to the Microsoft home page.
            get_Response().Redirect("http://www.microsoft.com/");
        } //ImageButton1_Command
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom ImageButton - AddAttributesToRender - VJ# Example</h3>
            
            <aspSample:CustomImageButtonAddAttributesToRender id="ImageButton1"
 runat="server" 
             OnCommand="ImageButton1_Command" AlternateText="Microsoft
 Home" 
             ImageUrl="http://www.microsoft.com/homepage/gif/bnr-microsoft.gif"
 />

        </form>
    </body>
</HTML>
<br /><span space="preserve">...</span><br />package
 Samples.AspNet.JSL.Controls; 

public class CustomImageButtonAddAttributesToRender
    extends System.Web.UI.WebControls.ImageButton
{
    protected void AddAttributesToRender(System.Web.UI.HtmlTextWriter
 writer)
    {
        // Show the ImageButton with a thin border.
        writer.AddStyleAttribute("border-width", "thin");
        // Call the Base's AddAttributesToRender method.
        super.AddAttributesToRender(writer);
    } //AddAttributesToRender
} //CustomImageButtonAddAttributesToRender