TableCell.AddAttributesToRender(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í.
Agrega las propiedades específicas del control TableCell a la lista de atributos que se van a representar.
protected:
override void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
protected override void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub AddAttributesToRender (writer As HtmlTextWriter)
Parámetros
- writer
- HtmlTextWriter
Flujo de salida que representa el contenido HTML en el cliente.
Excepciones
No se encontró una celda enumerada como celda de encabezado asociada.
Ejemplos
En el ejemplo de código siguiente se muestra cómo invalidar el AddAttributesToRender método en un control de servidor personalizado para que se represente un atributo de título personalizado para cada 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 - AddAttributesToRender - C# Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Custom TableCell - AddAttributesToRender - C# Example</h3>
<asp:Table id="Table1" runat="server"
CellPadding="3" CellSpacing="2">
<asp:TableRow>
<aspSample:CustomTableCellAddAttributesToRender Text="(0,0)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(0,1)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(0,2)" />
</asp:TableRow>
<asp:TableRow>
<aspSample:CustomTableCellAddAttributesToRender Text="(1,0)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(1,1)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(1,2)" />
</asp:TableRow>
</asp:Table>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.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 - AddAttributesToRender - VB.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Custom TableCell - AddAttributesToRender - VB Example</h3>
<asp:Table id="Table1" runat="server"
CellPadding="3" CellSpacing="2">
<asp:TableRow>
<aspSample:CustomTableCellAddAttributesToRender Text="(0,0)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(0,1)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(0,2)" />
</asp:TableRow>
<asp:TableRow>
<aspSample:CustomTableCellAddAttributesToRender Text="(1,0)" />
<aspSample:CustomTableCellAddAttributesToRender Text="(1,1)" />
<aspSample:CustomTableCellAddAttributesToRender 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 CustomTableCellAddAttributesToRender : System.Web.UI.WebControls.TableCell
{
protected override void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer)
{
// Write a Title attribute.
writer.AddAttribute("title", "CustomAddAttributesToRender");
// Call the base AddAttributesToRender method.
base.AddAttributesToRender(writer);
}
}
}
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomTableCellAddAttributesToRender
Inherits System.Web.UI.WebControls.TableCell
Protected Overrides Sub AddAttributesToRender(ByVal writer As System.Web.UI.HtmlTextWriter)
' Write a Title attribute.
writer.AddAttribute("title", "CustomAddAttributesToRender")
' Call the base AddAttributesToRender method.
MyBase.AddAttributesToRender(writer)
End Sub
End Class
End Namespace
Comentarios
El AddAttributesToRender método invalida el método de AddAttributesToRender la clase base y primero llama al método base y, a continuación, agrega los TableCell atributos correspondientes a la RowSpan propiedad , la ColumnSpan propiedad y la AssociatedHeaderCellID propiedad . Si la AssociatedHeaderCellID propiedad hace referencia a un TableHeaderCell objeto que no se encuentra, se produce una HttpException excepción .
El AddAttributesToRender método se usa principalmente por los desarrolladores de controles que amplían la funcionalidad del TableCell control.
Notas a los desarrolladores de herederos
Al invalidar el AddAttributesToRender(HtmlTextWriter) método en una clase derivada, asegúrese de llamar al AddAttributesToRender(HtmlTextWriter) método de la clase base para que los TableCell atributos de control se representen correctamente.