Freigeben über


TableCell.RenderContents-Methode

Diese Methode unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

Gibt die Inhalte der TableCell in das angegebene HtmlTextWriter-Objekt 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
    Der Ausgabestream, der HTML-Inhalt für den Client wiedergibt.

Hinweise

Wenn das TableCell-Steuerelement über untergeordnete Steuerelemente verfügt oder in einer abgeleiteten Klasse überschrieben wird, wird die RenderContents-Methode der Basisklasse aufgerufen, andernfalls wird der Wert der Text-Eigenschaft in das HtmlTextWriter-Objekt geschrieben.

Die RenderContents-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des TableCell-Steuerelements verwendet.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der RenderContents-Methode in einem benutzerdefinierten TableCell-Steuerelement veranschaulicht, sodass der benutzerdefinierte Text in den Zelleninhalt eingefügt wird.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - RenderContents - VB.NET Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TableCell - RenderContents - VB.NET Example</h3>
            
            <asp:Table id="Table1" runat="server" CellPadding="3" CellSpacing="2">
                <asp:TableRow>
                    <aspSample:CustomTableCellRenderContents Text="(0,0)" />
                    <aspSample:CustomTableCellRenderContents Text="(0,1)" />
                    <aspSample:CustomTableCellRenderContents Text="(0,2)" />
                </asp:TableRow>
                <asp:TableRow>
                    <aspSample:CustomTableCellRenderContents Text="(1,0)" />
                    <aspSample:CustomTableCellRenderContents Text="(1,1)" />
                    <aspSample:CustomTableCellRenderContents Text="(1,2)" />
                </asp:TableRow>
            </asp:Table>
        </form>
    </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - RenderContents - C# Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TableCell - RenderContents - C# Example</h3>
      
      <asp:Table 
        id="Table1" 
        runat="server" 
        CellPadding="3" 
        CellSpacing="2">
        <asp:TableRow>
          <aspSample:CustomTableCellRenderContents Text="(0,0)" />
          <aspSample:CustomTableCellRenderContents Text="(0,1)" />
          <aspSample:CustomTableCellRenderContents Text="(0,2)" />
        </asp:TableRow>
        <asp:TableRow>
          <aspSample:CustomTableCellRenderContents Text="(1,0)" />
          <aspSample:CustomTableCellRenderContents Text="(1,1)" />
          <aspSample:CustomTableCellRenderContents Text="(1,2)" />
        </asp:TableRow>
      </asp:Table>
      
        </form>
    </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - RenderContents - VJ# Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TableCell - RenderContents - VJ# Example</h3>
      
      <asp:Table 
        id="Table1" 
        runat="server" 
        CellPadding="3" 
        CellSpacing="2">
        <asp:TableRow>
          <aspSample:CustomTableCellRenderContents Text="(0,0)" />
          <aspSample:CustomTableCellRenderContents Text="(0,1)" />
          <aspSample:CustomTableCellRenderContents Text="(0,2)" />
        </asp:TableRow>
        <asp:TableRow>
          <aspSample:CustomTableCellRenderContents Text="(1,0)" />
          <aspSample:CustomTableCellRenderContents Text="(1,1)" />
          <aspSample:CustomTableCellRenderContents Text="(1,2)" />
        </asp:TableRow>
      </asp:Table>
      
        </form>
    </body>
</html>
Imports System.Web
Imports System.Security.Permissions

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

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

            ' Insert text into each TableCell.
            writer.Write("TableCell: ")

            ' Call the base RenderContents method.
            MyBase.RenderContents(writer)

        End Sub

    End Class

End Namespace
using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTableCellRenderContents : System.Web.UI.WebControls.TableCell
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Insert text into each TableCell.
      writer.Write("TableCell: ");

      // Call the base RenderContents method.
      base.RenderContents(writer);
    }
  }
}
package Samples.AspNet.JSL.Controls; 

public class CustomTableCellRenderContents
    extends System.Web.UI.WebControls.TableCell
{
    protected void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
        // Insert text into each TableCell.
        writer.Write("TableCell: ");

        // Call the base RenderContents method.
        super.RenderContents(writer);

    } 
} 

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

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

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente