HtmlButton.RenderAttributes-Methode

Rendert die Attribute des HtmlButton-Steuerelements in das angegebene HtmlTextWriter-Objekt.

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

Syntax

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

Me.RenderAttributes(writer)

protected override void RenderAttributes (
    HtmlTextWriter writer
)

protected:
virtual void RenderAttributes (
    HtmlTextWriter^ writer
) override

protected void RenderAttributes (
    HtmlTextWriter writer
)

protected override function RenderAttributes (
    writer : HtmlTextWriter
)

Parameter

writer
Der HtmlTextWriter mit dem Ausgabestream, der auf dem Client gerendert werden soll.

Hinweise

Die RenderAttributes-Methode schreibt das onclick-Attribut des gerenderten HtmlButton-Steuerelements und ruft dann die HtmlControl.RenderAttributes-Basismethode auf.

Die RenderAttributes-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des HtmlButton-Steuerelements verwendet.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der RenderAttributes-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass im HtmlButton-Steuerelement immer ein Titel angezeigt wird.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlButton - RenderAttributes - Visual Basic Example</title>
    <script runat="server">
      Sub Page_Load(sender As Object, e As EventArgs)
        HtmlButton1.Attributes.Add("onclick", "alert('Hello client-side world.');")
      End Sub

      Sub HtmlButton1_ServerClick(sender As Object, e As EventArgs)
        Div1.InnerHtml = "Hello server-side world."
      End Sub
    </script>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom HtmlButton - RenderAttributes - Visual Basic Example</h3>

      <aspSample:CustomHtmlButtonRenderAttributes
        id="HtmlButton1"
        runat="server"
        type="button"
        onserverclick="HtmlButton1_ServerClick"
        name="HtmlButton1">Html Button</aspSample:CustomHtmlButtonRenderAttributes>&nbsp;&nbsp;

      <DIV id="Div1" runat="server"
        style="DISPLAY: inline; WIDTH: 256px; HEIGHT: 15px"
        ms_positioning="FlowLayout" />
    </form>
  </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlButton - RenderAttributes - C# Example</title>
    <script runat="server">
      void Page_Load(Object sender, EventArgs e)
      {
        HtmlButton1.Attributes.Add("onclick","alert('Hello client-side world.');");
      }

      void HtmlButton1_ServerClick(Object sender, EventArgs e)
      {
        Div1.InnerHtml = "Hello server-side world.";
      }
    </script>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom HtmlButton - RenderAttributes - C# Example</h3>

      <aspSample:CustomHtmlButtonRenderAttributes
        id="HtmlButton1"
        runat="server"
        type="button"
        onserverclick="HtmlButton1_ServerClick"
        name="HtmlButton1">Html Button</aspSample:CustomHtmlButtonRenderAttributes>&nbsp;&nbsp;

      <DIV id="Div1" runat="server"
        style="DISPLAY: inline; WIDTH: 256px; HEIGHT: 15px"
        ms_positioning="FlowLayout" />
    </form>
  </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
  <HEAD>
    <title>Custom HtmlButton - RenderAttributes - VJ# Example</title>
    <script runat="server">
        
    void Page_Load(Object sender, EventArgs e)
    {
        HtmlButton1.get_Attributes().Add("onclick",
            "alert('Hello client-side world.');");
    } //Page_Load

    void HtmlButton1_ServerClick(Object sender, EventArgs e)
    {
        Div1.set_InnerHtml("Hello server-side world.");
    } //HtmlButton1_ServerClick
    </script>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom HtmlButton - RenderAttributes - VJ# Example</h3>

      <aspSample:CustomHtmlButtonRenderAttributes
        id="HtmlButton1"
        runat="server"
        type="button"
        onserverclick="HtmlButton1_ServerClick"
        name="HtmlButton1">Html Button</aspSample:CustomHtmlButtonRenderAttributes>&nbsp;&nbsp;

      <DIV id="Div1" runat="server"
        style="DISPLAY: inline; WIDTH: 256px; HEIGHT: 15px"
        ms_positioning="FlowLayout" />
    </form>
  </body>
</HTML>

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomHtmlButtonRenderAttributes
        Inherits System.Web.UI.HtmlControls.HtmlButton

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

            ' Call the base class's RenderAttributes method.
            MyBase.RenderAttributes(writer)

            ' Write out the HtmlButton control's Title tag.
            writer.Write(" Title=""Text from RenderAttributes.""")
        End Sub
    End Class

End Namespace

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

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomHtmlButtonRenderAttributes : System.Web.UI.HtmlControls.HtmlButton
    {
        protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
        {
            
            // Call the base class's RenderAttributes method.
            base.RenderAttributes(writer);

            // Write out the HtmlButton control's Title tag.
            writer.Write(" Title=\"Text from RenderAttributes.\"");
        }
    }
}

package Samples.AspNet.JSL.Controls;

public class CustomHtmlButtonRenderAttributes
    extends System.Web.UI.HtmlControls.HtmlButton
{
    protected void RenderAttributes(System.Web.UI.HtmlTextWriter writer)
    {

        // Call the base's RenderAttributes method.
        super.RenderAttributes(writer);

        // Write out Title tag
        writer.Write(" Title=\"Text from RenderAttributes.\"");

    } //RenderAttributes
} //CustomHtmlButtonRenderAttributes

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

HtmlButton-Klasse
HtmlButton-Member
System.Web.UI.HtmlControls-Namespace
HtmlControl.RenderAttributes

Weitere Ressourcen

HTML-Serversteuerelemente

Last updated on 2007-08-20

Freigeben über