ValidationSummary.Render(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將伺服器控制項內容傳送到提供的 HtmlTextWriter 物件,以寫入要在用戶端上呈現的內容。
protected:
override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected override void Render (System.Web.UI.HtmlTextWriter writer);
protected internal override void Render (System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub Render (writer As HtmlTextWriter)
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)
參數
- writer
- HtmlTextWriter
將 HTML 內容呈現給用戶端的輸出資料流。
範例
下列程式代碼範例示範如何在自定義伺服器控制項中覆寫 Render 方法, ValidationSummary 讓控件以卷標括住 Small 。
重要
這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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" style="background-color:#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>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<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" style="background-color:#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();
}
}
}
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