ImageButton.AddAttributesToRender-Methode

Artikel
08/20/2007

Fügt dem Ausgabestream die Attribute eines ImageButton hinzu, der auf dem Client wiedergegeben werden soll.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overrides Sub AddAttributesToRender ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.AddAttributesToRender(writer)

protected override void AddAttributesToRender (
    HtmlTextWriter writer
)

protected:
virtual void AddAttributesToRender (
    HtmlTextWriter^ writer
) override

protected void AddAttributesToRender (
    HtmlTextWriter writer
)

protected override function AddAttributesToRender (
    writer : HtmlTextWriter
)

Parameter

writer
Der auf dem Client wiederzugebende Ausgabestream.

Hinweise

Die OnPreRender-Methode wird primär von Steuerelemententwicklern beim Ableiten einer benutzerdefinierten Klasse vom ImageButton-Steuerelement verwendet.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der AddAttributesToRender-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass der ImageButton-Text immer mit einem dünnen Rahmen angezeigt wird.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Der erste Teil dieses Codebeispiels muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Der zweite Teil muss als Codedatei (entweder CS-Datei für C# oder VB-Datei für Visual Basic) gespeichert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ 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("https://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="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />

        </form>
    </body>
</HTML>

...
    <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("https://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="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />

        </form>
    </body>
</HTML>

...
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("https://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="https://www.microsoft.com/homepage/gif/bnr-microsoft.gif" />

        </form>
    </body>
</HTML>

...
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

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ImageButton-Klasse
ImageButton-Member
System.Web.UI.WebControls-Namespace

Weitere Ressourcen

Deklarative Syntax des ImageButton-Webserversteuerelements
Übersicht über die Button-Webserversteuerelemente

Freigeben über