Freigeben über

ValidationSummary.Render-Methode

Diese Methode unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

Sendet den Inhalt eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt, das den Inhalt für die Wiedergabe auf dem Client schreibt.

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
    Der Ausgabestream, der HTML-Inhalt auf dem Client wiedergibt.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die Render-Methode in einem benutzerdefinierten Serversteuerelement so überschrieben wird, dass das ValidationSummary-Steuerelement von einem Small-Tag umgeben ist.

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

            <TABLE id="Table1" cellPadding="4" cellspacing="0">
                <TR>
                    <TD>
                        <TABLE id="Table2" cellPadding="4" cellspacing="0" bgColor="#eeeeee">
                            <TR>
                                <TD colSpan="3"><B>Credit Card Information</B> </TD>
                            </TR>
                            <TR>
                                <TD align="right">Card Type: </TD>
                                <TD><asp:RadioButtonList id="RadioButtonList1" runat="server" RepeatLayout="Flow">
                                        <asp:ListItem>MasterCard</asp:ListItem>
                                        <asp:ListItem>Visa</asp:ListItem>
                                    </asp:RadioButtonList>
                                </TD>
                                <TD align="center" rowSpan="1">
                                    <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
                                        runat="server" ErrorMessage="Card Type" Width="100%" 
                                        Display="Static" ControlToValidate="RadioButtonList1">*</asp:RequiredFieldValidator>
                                </TD>
                            </TR>
                            <TR>
                                <TD align="right">Card Number: </TD>
                                <TD><asp:TextBox id="TextBox1" runat="server"></asp:TextBox></TD>
                                <TD>
                                    <asp:RequiredFieldValidator id="RequiredFieldValidator2" 
                                        runat="server" ErrorMessage="Card Number" Width="100%" 
                                        Display="Static" ControlToValidate="TextBox1">*</asp:RequiredFieldValidator>
                                </TD>
                            </TR>
                            <TR>
                                <TD></TD>
                                <TD><asp:Button id="Button1" runat="server" text="Validate"></asp:Button></TD>
                                <TD></TD>
                            </TR>
                        </TABLE>

                    </TD>
                </TR>
                <TR>
                    <TD vAlign="top">
                        <aspSample:CustomValidationSummaryRender
                         id="ValidationSummary1" runat="server" DisplayMode="BulletList" 
                         HeaderText="You must enter a value in the following fields:" />
                    </TD>
                </TR>
            </TABLE>


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

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

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

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

            ' Write out begining Small HTML tag.
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Small)

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

            ' Write out ending Small HTML tag.
            writer.RenderEndTag()
        End Sub
    End Class
End Namespace

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

      <TABLE id="Table1" cellPadding="4" cellspacing="0">
        <TR>
          <TD>
            <TABLE id="Table2" cellPadding="4" cellspacing="0" bgColor="#eeeeee">
              <TR>
                <TD colSpan="3"><B>Credit Card Information</B> </TD>
              </TR>
              <TR>
                <TD align="right">Card Type: </TD>
                <TD>
                  <asp:RadioButtonList id="RadioButtonList1" runat="server" RepeatLayout="Flow">
                      <asp:ListItem>MasterCard</asp:ListItem>
                      <asp:ListItem>Visa</asp:ListItem>
                  </asp:RadioButtonList>
                </TD>
                <TD align="center" rowSpan="1">
                  <asp:RequiredFieldValidator 
                    id="RequiredFieldValidator1" 
                    runat="server" 
                    ErrorMessage="Card Type" 
                    Width="100%" 
                    Display="Static" 
                    ControlToValidate="RadioButtonList1">*
                  </asp:RequiredFieldValidator>
                </TD>
              </TR>
              <TR>
                <TD align="right">Card Number: </TD>
                <TD><asp:TextBox id="TextBox1" runat="server"></asp:TextBox></TD>
                <TD>
                  <asp:RequiredFieldValidator 
                    id="RequiredFieldValidator2" 
                    runat="server" 
                    ErrorMessage="Card Number" 
                    Width="100%" 
                    Display="Static" 
                    ControlToValidate="TextBox1">*
                  </asp:RequiredFieldValidator>
                </TD>
              </TR>
              <TR>
                <TD></TD>
                <TD><asp:Button id="Button1" runat="server" text="Validate"></asp:Button></TD>
                <TD></TD>
              </TR>
            </TABLE>

          </TD>
        </TR>
        <TR>
          <TD vAlign="top">
            <aspSample:CustomValidationSummaryRender
              id="ValidationSummary1" 
              runat="server" 
              DisplayMode="BulletList" 
              HeaderText="You must enter a value in the following fields:" />
          </TD>
        </TR>
      </TABLE>


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

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

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomValidationSummaryRender : System.Web.UI.WebControls.ValidationSummary
  {
    protected override void Render(System.Web.UI.HtmlTextWriter writer)
    {
      // Write out begining Small HTML tag.
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Small);

      // Call the base class's Render method.
      base.Render(writer);

      // Write out ending Small HTML tag.
      writer.RenderEndTag();
    }
  }
}

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

      <TABLE id="Table1" cellPadding="4" cellspacing="0">
        <TR>
          <TD>
            <TABLE id="Table2" cellPadding="4" cellspacing="0" bgColor="#eeeeee">
              <TR>
                <TD colSpan="3"><B>Credit Card Information</B> </TD>
              </TR>
              <TR>
                <TD align="right">Card Type: </TD>
                <TD>
                  <asp:RadioButtonList id="RadioButtonList1" runat="server" RepeatLayout="Flow">
                      <asp:ListItem>MasterCard</asp:ListItem>
                      <asp:ListItem>Visa</asp:ListItem>
                  </asp:RadioButtonList>
                </TD>
                <TD align="center" rowSpan="1">
                  <asp:RequiredFieldValidator 
                    id="RequiredFieldValidator1" 
                    runat="server" 
                    ErrorMessage="Card Type" 
                    Width="100%" 
                    Display="Static" 
                    ControlToValidate="RadioButtonList1">*
                  </asp:RequiredFieldValidator>
                </TD>
              </TR>
              <TR>
                <TD align="right">Card Number: </TD>
                <TD><asp:TextBox id="TextBox1" runat="server"></asp:TextBox></TD>
                <TD>
                  <asp:RequiredFieldValidator 
                    id="RequiredFieldValidator2" 
                    runat="server" 
                    ErrorMessage="Card Number" 
                    Width="100%" 
                    Display="Static" 
                    ControlToValidate="TextBox1">*
                  </asp:RequiredFieldValidator>
                </TD>
              </TR>
              <TR>
                <TD></TD>
                <TD><asp:Button id="Button1" runat="server" text="Validate"></asp:Button></TD>
                <TD></TD>
              </TR>
            </TABLE>

          </TD>
        </TR>
        <TR>
          <TD vAlign="top">
            <aspSample:CustomValidationSummaryRender
              id="ValidationSummary1" 
              runat="server" 
              DisplayMode="BulletList" 
              HeaderText="You must enter a value in the following fields:" />
          </TD>
        </TR>
      </TABLE>


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

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

public class CustomValidationSummaryRender
    extends System.Web.UI.WebControls.ValidationSummary
{
    protected void Render(System.Web.UI.HtmlTextWriter writer)
    {
        // Write out begining Small HTML tag.
        writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Small);
        // Call the base class's Render method.
        super.Render(writer);
        // Write out ending Small HTML tag.
        writer.RenderEndTag();
    } //Render
} //CustomValidationSummaryRender

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

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

  • Last updated on