AttributeCollection.Render(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將該集合所屬控制項的指定 HtmlTextWriter 輸出串流中寫入屬性集合。
public:
void Render(System::Web::UI::HtmlTextWriter ^ writer);public void Render(System.Web.UI.HtmlTextWriter writer);member this.Render : System.Web.UI.HtmlTextWriter -> unitPublic Sub Render (writer As HtmlTextWriter)參數
- writer
- HtmlTextWriter
一個 HtmlTextWriter 將屬性集合寫入當前輸出串流的實例。
範例
本節包含兩個程式代碼範例。 第一個程式碼範例展示了如何從 WebControl 類別繼承，建立一個自訂控制 AttribRender 項來覆蓋該 Render 方法。 第二個程式碼範例展示了如何在 ASP.NET 網頁中使用自訂控制項。
以下範例展示了如何建立一個自訂控制項， AttribRender 該控制項能 Render 覆蓋類別的方法 WebControl ，而不 Render 使用基底類別的方法。 相反地， AttribRender 會引用該 Render 方法。
/* Create a custom WebControl class, named AttribRender, that overrides
the Render method to write two introductory strings. Then call the
AttributeCollection.Render method, which allows the control to write the
attribute values that are added to it when it is included in a page.
*/
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
// Create the namespace that contains the AttribRender and the
// page that accesses it.
namespace AC_Render
{
// This is the custom WebControl class.
[AspNetHostingPermission(SecurityAction.Demand,
Level=AspNetHostingPermissionLevel.Minimal)]
public class AttribRender : WebControl
{
// This is the overridden WebControl.Render method.
protected override void Render(HtmlTextWriter output)
{
output.Write("<h2>An AttributeCollection.Render Method Example</h2>");
output.Write("The attributes, and their values, added to the ctl1 control are <br><br>");
// This is the AttributeCollection.Render method call. When the
// page that contains this control is requested, the
// attributes that the page adds, and their values,
// are rendered to the page.
Attributes.Render(output);
}
}
}
' Create a custom WebControl class, named AttribRender, that overrides
' the Render method to write two introductory strings. Then call the
' AttributeCollection.Render method, which allows the control to write the
' attribute values that are added to it when it is included in a page.
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
' Create the namespace that contains the AttribRender and the
' page that accesses it.
Namespace AC_Render
' This is the custom WebControl class.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class AttribRender
Inherits WebControl
' This is the overridden WebControl.Render method.
Protected Overrides Sub Render(ByVal output As HtmlTextWriter)
output.Write("<h2>An AttributeCollection.Render Method Example</h2>")
output.Write("The attributes, and their values, added to the ctl1 control are <br><br>")
' This is the AttributeCollection.Render method call. When the
' page that contains this control is requested, the
' attributes that the page adds, and their values,
' are rendered to the page.
Attributes.Render(output)
End Sub
End Class
End Namespace 'AC_Render
以下範例展示了如何在網頁中使用 AttribRender 自訂控制項。 它假設自訂控制的程式碼檔案位於該應用程式的App_Code資料夾中。
<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
AC_Render.AttribRender c = new AC_Render.AttribRender();
c.Attributes.Add("Text", "Hello World!");
c.Attributes.Add("Attribute1", "The value for Attribute1.");
Place1.Controls.Add(c);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>AttributeCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:PlaceHolder id="Place1" runat="server"></asp:PlaceHolder>
</div>
</form>
</body>
</html>
<%@ Page Language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim c As New AC_Render.AttribRender()
c.Attributes.Add("Text", "Hello World!")
c.Attributes.Add("Attribute1", "The value for Attribute1.")
Place1.Controls.Add(c)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>AttributeCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:PlaceHolder id="Place1" runat="server"></asp:PlaceHolder>
</div>
</form>
</body>
</html>
