Table.RenderContents(HtmlTextWriter) Método

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Renderiza as linhas no controle de tabela no gravador especificado.

protected:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);

protected public:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);

protected override void RenderContents (System.Web.UI.HtmlTextWriter writer);

protected internal override void RenderContents (System.Web.UI.HtmlTextWriter writer);

override this.RenderContents : System.Web.UI.HtmlTextWriter -> unit

Protected Overrides Sub RenderContents (writer As HtmlTextWriter)

Protected Friend Overrides Sub RenderContents (writer As HtmlTextWriter)

Parâmetros

writer: HtmlTextWriter

Um HtmlTextWriter que representa o fluxo de saída para renderizar o conteúdo HTML no cliente.

Exceções

HttpException

As seções da tabela não estão em ordem.

Exemplos

O exemplo de código a seguir demonstra como substituir o RenderContents método em um controle de servidor personalizado para que ele sempre insira uma linha de cabeçalho para um controle de servidor personalizado Table .

<%@ 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 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>

<%@ 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 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>

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);
    }
  }
}

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

Comentários

Esse método é usado principalmente por desenvolvedores de controle ao derivar uma classe personalizada de um Table controle.

O Table controle implementa o RenderContents para renderizar o Rows da tabela.

Aplica-se a

Confira também

Visão geral do controle de servidor Web Table, TableRow e TableCell

Partilhar via