TableCell.RenderContents(HtmlTextWriter) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa el contenido de TableCell en el objeto HtmlTextWriter 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
Flujo de salida que representa el contenido HTML en el cliente.
Ejemplos
En el ejemplo de código siguiente se muestra cómo invalidar el RenderContents método en un control personalizado TableCell para que se inserte texto personalizado en el contenido de la celda.
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="Samples.AspNet.CS" %>
<!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 id="Head2" runat="server">
<title>Custom TableCell - RenderContents - C# Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<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>
</div>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" %>
<!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 id="Head2" runat="server">
<title>Custom TableCell - RenderContents - VB.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<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>
</div>
</form>
</body>
</html>
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);
}
}
}
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
Comentarios
Si el TableCell control tiene controles secundarios o se invalida en una clase derivada, se llama al método de RenderContents la clase base; de lo contrario, el valor de la Text propiedad se escribe en el HtmlTextWriter objeto .
El RenderContents método se usa principalmente por los desarrolladores de controles que amplían la funcionalidad del TableCell control.