RadioButtonList.Render-Methode

Zeigt das RadioButtonList-Steuerelement auf dem Client an.

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

Syntax

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

Me.Render(writer)

protected internal override void Render (
    HtmlTextWriter writer
)

protected public:
virtual void Render (
    HtmlTextWriter^ writer
) override

protected void Render (
    HtmlTextWriter writer
)

protected internal override function Render (
    writer : HtmlTextWriter
)

Parameter

writer
Ein System.Web.UI.HtmlTextWriter, der den Ausgabestream für die Wiedergabe auf dem Client enthält.

Hinweise

Diese Methode wird primär von Steuerelemententwicklern beim Ableiten eines benutzerdefinierten Steuerelements von der RadioButtonList-Klasse verwendet.

Die Implementierung der Render-Methode für ein RadioButtonList-Steuerelement initialisiert ein RepeatInfo-Objekt für die Liste und ruft die RenderRepeater-Methode auf, die wiederum mithilfe der RenderItem-Methode einzelne Elemente der Optionsfeldliste darstellt.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der Render-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass das RadioButtonList-Objekt immer mit beschreibendem Text angezeigt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<HTML>
    <HEAD><title>Custom RadioButtonList - Render - VB.NET Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom RadioButtonList - Render - VB.NET Example</h3>

            <aspSample:CustomRadioButtonListRender
             id="Radiobuttonlist1" runat="server" 
             RepeatColumns="2" RepeatDirection="Horizontal">
                <asp:ListItem Value="Item1">Item1</asp:ListItem>
                <asp:ListItem Value="Item2">Item2</asp:ListItem>
                <asp:ListItem Value="Item3">Item3</asp:ListItem>
                <asp:ListItem Value="Item4">Item4</asp:ListItem>
            </aspSample:CustomRadioButtonListRender>
        </form>
    </body>
</HTML>

...
Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomRadioButtonListRender
        Inherits System.Web.UI.WebControls.RadioButtonList

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

            ' Call the base RenderContents method.
            MyBase.Render(writer)

            ' Append some text to the Image.
            writer.Write("Experience Windows Server 2003 and Visual Studio .NET 2003.")
        End Sub 'Render
    End Class
End Namespace

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<HTML>
  <HEAD>
    <title>Custom RadioButtonList - Render - C# Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom RadioButtonList - Render - C# Example</h3>

      <aspSample:CustomRadioButtonListRender 
        id="Radiobuttonlist1" 
        runat="server" 
        RepeatColumns="2" 
        RepeatDirection="Horizontal">
        <asp:ListItem Value="Item1">Item1</asp:ListItem>
        <asp:ListItem Value="Item2">Item2</asp:ListItem>
        <asp:ListItem Value="Item3">Item3</asp:ListItem>
        <asp:ListItem Value="Item4">Item4</asp:ListItem>
      </aspSample:CustomRadioButtonListRender>
      
    </form>
  </body>
</HTML>

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

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomRadioButtonListRender : System.Web.UI.WebControls.RadioButtonList
  {
    protected override void Render(System.Web.UI.HtmlTextWriter writer)
    {
      // Call the base RenderContents method.
      base.Render(writer);

      // Append some text to the Image.
      writer.Write("Experience Windows Server 2003 and Visual Studio .NET 2003.");
    }
  }
}

<%@ Page Language="VJ#" AutoEventWireup="True" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<HTML>
  <HEAD>
    <title>Custom RadioButtonList - Render - VJ# Example</title>
  </HEAD>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>Custom RadioButtonList - Render - VJ# Example</h3>

      <aspSample:CustomRadioButtonListRender 
        id="Radiobuttonlist1" 
        runat="server" 
        RepeatColumns="2" 
        RepeatDirection="Horizontal">
        <asp:ListItem Value="Item1">Item1</asp:ListItem>
        <asp:ListItem Value="Item2">Item2</asp:ListItem>
        <asp:ListItem Value="Item3">Item3</asp:ListItem>
        <asp:ListItem Value="Item4">Item4</asp:ListItem>
      </aspSample:CustomRadioButtonListRender>
      
    </form>
  </body>
</HTML>

...
package Samples.AspNet.JSL.Controls;

public class CustomRadioButtonListRender
    extends System.Web.UI.WebControls.RadioButtonList
{
    protected void Render(System.Web.UI.HtmlTextWriter writer)
    {
        // Call the base RenderContents method.
        super.Render(writer);
        // Append some text to the Image.
        writer.Write("Experience Windows Server 2003 and "
            + "Visual Studio .NET 2003.");
    } //Render
} //CustomRadioButtonListRender

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

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

Weitere Ressourcen

RadioButton- und RadioButtonList-Webserver-Steuerelemente

Last updated on 2007-08-20

Freigeben über