Freigeben über


Table.RenderContents-Methode

Gibt die Zeilen im Tabellensteuerelement im angegebenen Writer 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-Objekt, das den Ausgabestream für die Wiedergabe von HTML-Inhalten auf dem Client darstellt.

Hinweise

Diese Methode wird primär von Steuerelemententwicklern beim Ableiten einer benutzerdefinierten Klasse von einem Table-Steuerelement verwendet.

Das Table-Steuerelement implementiert denRenderContents, um die Rows der Tabelle wiederzugeben.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die RenderContents-Methode in einem benutzerdefinierten Serversteuerelement überschrieben wird, um für ein benutzerdefiniertes Table-Serversteuerelement stets eine Headerzeile einzufügen.

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

            <aspSample:CustomTableRenderContents id="Table1" runat="server" GridLines="Both">
                <asp:TableRow>
                    <asp:TableCell>Row 0, Col 0</asp:TableCell>
                    <asp:TableCell>Row 0, Col 1</asp:TableCell>
                </asp:TableRow>
                <asp:TableRow>
                    <asp:TableCell>Row 1, Col 0</asp:TableCell>
                    <asp:TableCell>Row 1, Col 1</asp:TableCell>
                </asp:TableRow>
            </aspSample:CustomTableRenderContents>
        </form>
    </body>
</HTML>

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

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

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

            ' Insert a header row.
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr)
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th)
            writer.Write("Col 0")
            writer.RenderEndTag()
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th)
            writer.Write("Col 1")
            writer.RenderEndTag()
            writer.RenderEndTag()

            ' Call the base RenderContents method.
            MyBase.RenderContents(writer)
        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 Table - RenderContents - C# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Table - RenderContents - C# Example</h3>
            
            <aspSample:CustomTableRenderContents 
              id="Table1" 
              runat="server" 
              GridLines="Both">
        <asp:TableRow>
          <asp:TableCell>Row 0, Col 0</asp:TableCell>
          <asp:TableCell>Row 0, Col 1</asp:TableCell>
        </asp:TableRow>
        <asp:TableRow>
          <asp:TableCell>Row 1, Col 0</asp:TableCell>
          <asp:TableCell>Row 1, Col 1</asp:TableCell>
        </asp:TableRow>
      </aspSample:CustomTableRenderContents>
        
        </form>
    </body>
</HTML>

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

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTableRenderContents : System.Web.UI.WebControls.Table
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Insert a header row.
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr);
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 0");
      writer.RenderEndTag();
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 1");
      writer.RenderEndTag();
      writer.RenderEndTag();

      // Call the base RenderContents method.
      base.RenderContents(writer);
    }
  }
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Table - RenderContents - VJ# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Table - RenderContents - VJ# Example</h3>
            
            <aspSample:CustomTableRenderContents 
              id="Table1" 
              runat="server" 
              GridLines="Both">
        <asp:TableRow>
          <asp:TableCell>Row 0, Col 0</asp:TableCell>
          <asp:TableCell>Row 0, Col 1</asp:TableCell>
        </asp:TableRow>
        <asp:TableRow>
          <asp:TableCell>Row 1, Col 0</asp:TableCell>
          <asp:TableCell>Row 1, Col 1</asp:TableCell>
        </asp:TableRow>
      </aspSample:CustomTableRenderContents>
        
        </form>
    </body>
</HTML>

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

public class CustomTableRenderContents
    extends System.Web.UI.WebControls.Table
{
    protected void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
        // Insert a header row.
        writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr);
        writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
        writer.Write("Col 0");
        writer.RenderEndTag();
        writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
        writer.Write("Col 1");
        writer.RenderEndTag();
        writer.RenderEndTag();
        // Call the base RenderContents method.
        super.RenderContents(writer);
    } //RenderContents
} //CustomTableRenderContents

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

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

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente