TableCell.AddAttributesToRender(HtmlTextWriter) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge proprietà specifiche del controllo TableCell all'elenco di attributi di cui eseguire il rendering.
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)
Parametri
- writer
- HtmlTextWriter
Flusso di output che esegue il rendering del contenuto HTML nel client.
Eccezioni
Non è stata trovata una cella elencata come cella di intestazione associata.
Esempio
Nell'esempio di codice seguente viene illustrato come eseguire l'override del metodo in un controllo server personalizzato in modo che venga eseguito il AddAttributesToRender rendering di un attributo titolo personalizzato per ogni cella.
<%@ 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
Commenti
Il AddAttributesToRender metodo esegue l'override del metodo della AddAttributesToRender classe base e chiama prima il metodo base e quindi aggiunge gli TableCell attributi corrispondenti alla RowSpan proprietà, ColumnSpan alla proprietà e alla AssociatedHeaderCellID proprietà. Se la AssociatedHeaderCellID proprietà fa riferimento a un TableHeaderCell oggetto che non è possibile trovare, viene generata una HttpException proprietà.
Il AddAttributesToRender metodo viene usato principalmente dagli sviluppatori di controlli che estendono la funzionalità del TableCell controllo.
Note per gli eredi
Quando si esegue l'override del metodo in una classe derivata, assicurarsi di chiamare il AddAttributesToRender(HtmlTextWriter)AddAttributesToRender(HtmlTextWriter) metodo della classe base in modo che gli TableCell attributi del controllo vengano visualizzati correttamente.