DataList.RenderContents-Methode
Gibt die Listenelemente im DataList-Steuerelement wieder.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Friend Overrides Sub RenderContents ( _
writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter
Me.RenderContents(writer)
protected internal override void RenderContents (
HtmlTextWriter writer
)
protected public:
virtual void RenderContents (
HtmlTextWriter^ writer
) override
protected void RenderContents (
HtmlTextWriter writer
)
protected internal override function RenderContents (
writer : HtmlTextWriter
)
Parameter
- writer
Ein HtmlTextWriter, der den Ausgabestream zum Darstellen des HTML-Inhalts auf dem Client darstellt.
Hinweise
Die RenderContents-Methode wird primär von Steuerelemententwicklern beim Ableiten eines benutzerdefinierten Steuerelements vom DataList-Steuerelement verwendet.
Die RenderContents-Methode gibt den inneren Inhalt des DataList-Steuerelements wieder, einschließlich der enthaltenen DataListItem-Steuerelemente.
Beispiel
Im folgenden Codebeispiel wird das Überschreiben der RenderContents-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass ein bestimmter Text dem DataList-Objekt vorangestellt ist.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom DataList - RenderContents - VB.NET Example</title>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom DataList - RenderContents - VB.NET Example</h3>
<aspSample:CustomDataListRenderContents id="DataList1" runat="server" />
</form>
</body>
</HTML>
...
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomDataListRenderContents
Inherits System.Web.UI.WebControls.DataList
Protected Overrides Sub RenderContents(ByVal writer As System.Web.UI.HtmlTextWriter)
' Place some text before the DataList.
writer.Write("Here is some text from the RenderContent method.<br>")
' Call the base RenderContents method.
MyBase.RenderContents(writer)
End Sub
End Class
End Namespace
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom DataList - RenderContents - C# Example</title>
<script runat=server>
private void Page_Load(object sender, System.EventArgs e)
{
// Create sample data for the DataList control.
System.Data.DataTable dt = new System.Data.DataTable();
System.Data.DataRow dr;
dt.Columns.Add(new System.Data.DataColumn("Column1", typeof(String)));
dr = dt.NewRow();
dr[0] = "Hello";
dt.Rows.Add(dr);
dr = dt.NewRow();
dr[0] = "DataList";
dt.Rows.Add(dr);
dr = dt.NewRow();
dr[0] = "World";
dt.Rows.Add(dr);
// Show the DataTable values in the DataList.
DataList1.DataSource = dt;
DataList1.DataBind();
}
</script>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom DataList - RenderContents - C# Example</h3>
<aspSample:CustomDataListRenderContents id="DataList1" runat="server"
BorderColor="#999999" BorderStyle="None" BackColor="White" CellPadding="3"
GridLines="Vertical" BorderWidth="1px" Width="100px">
<HeaderStyle Font-Bold="True" ForeColor="White" BackColor="#000084" />
<HeaderTemplate>
<asp:Label id="Label1" runat="server">Column1</asp:Label>
</HeaderTemplate>
<ItemStyle ForeColor="Black" BackColor="#EEEEEE" />
<ItemTemplate>
<asp:Label id="Label2" runat="server"><%# DataBinder.Eval(Container.DataItem, "Column1") %></asp:Label>
</ItemTemplate>
<AlternatingItemStyle BackColor="#DCDCDC" />
<AlternatingItemTemplate>
<asp:Label id="Label3" runat="server"><%# DataBinder.Eval(Container.DataItem, "Column1") %></asp:Label>
</AlternatingItemTemplate>
</aspSample:CustomDataListRenderContents>
</form>
</body>
</HTML>
...
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomDataListRenderContents : System.Web.UI.WebControls.DataList
{
protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
{
// Place some text before the DataList.
writer.Write("Here is some text from the RenderContent method.<br>");
// Call the base RenderContents method.
base.RenderContents(writer);
}
}
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom DataList - RenderContents - VJ# Example</title>
<script runat=server>
private void Page_Load(Object sender, System.EventArgs e)
{
// Create sample data for the DataList control.
System.Data.DataTable dt = new System.Data.DataTable();
System.Data.DataRow dr;
dt.get_Columns().Add(new System.Data.DataColumn("Column1",
String.class.ToType()));
dr = dt.NewRow();
dr.set_Item(0, "Hello");
dt.get_Rows().Add(dr);
dr = dt.NewRow();
dr.set_Item(0, "DataList");
dt.get_Rows().Add(dr);
dr = dt.NewRow();
dr.set_Item(0, "World");
dt.get_Rows().Add(dr);
// Show the DataTable values in the DataList.
DataList1.set_DataSource(dt);
DataList1.DataBind();
} //Page_Load
</script>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom DataList - RenderContents - VJ# Example</h3>
<aspSample:CustomDataListRenderContents id="DataList1" runat="server"
BorderColor="#999999" BorderStyle="None" BackColor="White" CellPadding="3"
GridLines="Vertical" BorderWidth="1px" Width="100px">
<HeaderStyle Font-Bold="True" ForeColor="White" BackColor="#000084" />
<HeaderTemplate>
<asp:Label id="Label1" runat="server">Column1</asp:Label>
</HeaderTemplate>
<ItemStyle ForeColor="Black" BackColor="#EEEEEE" />
<ItemTemplate>
<asp:Label id="Label2" runat="server"><%# DataBinder.Eval(Container.get_DataItem(), "Column1") %></asp:Label>
</ItemTemplate>
<AlternatingItemStyle BackColor="#DCDCDC" />
<AlternatingItemTemplate>
<asp:Label id="Label3" runat="server"><%# DataBinder.Eval(Container.get_DataItem(), "Column1") %></asp:Label>
</AlternatingItemTemplate>
</aspSample:CustomDataListRenderContents>
</form>
</body>
</HTML>
...
package Samples.AspNet;
public class CustomDataListRenderContents
extends System.Web.UI.WebControls.DataList
{
protected void RenderContents(System.Web.UI.HtmlTextWriter writer)
{
// Place some text before the DataList.
writer.Write("Here is some text from the RenderContent method.<br>");
// Call the base RenderContents method.
super.RenderContents(writer);
} //RenderContents
} //CustomDataListRenderContents
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
DataList-Klasse
DataList-Member
System.Web.UI.WebControls-Namespace