HtmlTable.RenderChildren(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 HtmlTable 控制項的子控制項呈現為指定的 HtmlTextWriter 物件。
protected:
override void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);protected public:
override void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);protected override void RenderChildren (System.Web.UI.HtmlTextWriter writer);protected internal override void RenderChildren (System.Web.UI.HtmlTextWriter writer);override this.RenderChildren : System.Web.UI.HtmlTextWriter -> unitProtected Overrides Sub RenderChildren (writer As HtmlTextWriter)Protected Friend Overrides Sub RenderChildren (writer As HtmlTextWriter)參數
- writer
- HtmlTextWriter
HtmlTextWriter 接收轉譯的內容。
範例
下列程式碼範例示範如何在自訂伺服器控制項中覆寫 RenderChildren 方法，以便將新的資料表資料列附加至 HtmlTable 控制項。
<%@ 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 HtmlTable - RenderChildren Example</title>
</head>
<body>
<form id="Form1"
method="post"
runat="server">
<h3>Custom HtmlTable - RenderChildren Example</h3>
<aspSample:CustomHtmlTableRenderChildren
id="HtmlTable1"
name="HtmlTable1"
runat="server"
border="1"
cellSpacing="0"
cellPadding="5">
<tr>
<td>1,1</td>
<td>1,2</td>
<td>1,3</td>
</tr>
<tr>
<td>2,1</td>
<td>2,2</td>
<td>2,3</td>
</tr>
<tr>
<td>3,1</td>
<td>3,2</td>
<td>3,3</td>
</tr>
</aspSample:CustomHtmlTableRenderChildren>
</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 HtmlTable - RenderChildren Example</title>
</head>
<body>
<form id="Form1"
method="post"
runat="server">
<h3>Custom HtmlTable - RenderChildren Example</h3>
<aspSample:CustomHtmlTableRenderChildren
id="HtmlTable1"
name="HtmlTable1"
runat="server"
border="1"
cellSpacing="0"
cellPadding="5">
<tr>
<td>1,1</td>
<td>1,2</td>
<td>1,3</td>
</tr>
<tr>
<td>2,1</td>
<td>2,2</td>
<td>2,3</td>
</tr>
<tr>
<td>3,1</td>
<td>3,2</td>
<td>3,3</td>
</tr>
</aspSample:CustomHtmlTableRenderChildren>
</form>
</body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomHtmlTableRenderChildren : System.Web.UI.HtmlControls.HtmlTable
{
protected override void RenderChildren(System.Web.UI.HtmlTextWriter writer)
{
// Call the base class's RenderChildren method.
base.RenderChildren(writer);
// Write out a new table row.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr);
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td);
writer.Write("4,1");
writer.RenderEndTag();
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td);
writer.Write("4,2");
writer.RenderEndTag();
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td);
writer.Write("4,3");
writer.RenderEndTag();
writer.RenderEndTag();
}
}
}
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomHtmlTableRenderChildren
Inherits System.Web.UI.HtmlControls.HtmlTable
Protected Overrides Sub RenderChildren(ByVal writer As System.Web.UI.HtmlTextWriter)
' Call the base class's RenderChildren method.
MyBase.RenderChildren(writer)
' Write out a new table row.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr)
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td)
writer.Write("4,1")
writer.RenderEndTag()
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td)
writer.Write("4,2")
writer.RenderEndTag()
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Td)
writer.Write("4,3")
writer.RenderEndTag()
writer.RenderEndTag()
End Sub
End Class
End Namespace
備註
方法 RenderChildren 會在呼叫基類 Control.RenderChildren 的 方法之前和之後提供額外的格式。 其他格式可讓控制項的 HtmlTable 轉譯 HTML 更容易讀取，方法是在轉 HtmlTable 譯控制項的子控制項之前插入換行和縮排。
方法 RenderChildren 主要是由控制項開發人員使用，以擴充控制項的功能 HtmlTable 。