TableCell.AddAttributesToRender(HtmlTextWriter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет свойства, относящиеся к элементу TableCell управления, в список атрибутов для отрисовки.
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)
Параметры
- writer
- HtmlTextWriter
Выходной поток, который отображает HTML-содержимое клиенту.
Исключения
Ячейка, указанная как связанная ячейка заголовка, не найдена.
Примеры
В следующем примере кода показано, как переопределить AddAttributesToRender метод в пользовательском серверном элементе управления, чтобы настраиваемый атрибут заголовка отображался для каждой ячейки.
<%@ 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
Комментарии
Метод AddAttributesToRender переопределяет метод базового класса AddAttributesToRender и сначала вызывает базовый метод, а затем добавляет TableCell атрибуты, соответствующие RowSpan свойству, ColumnSpan свойству и свойству AssociatedHeaderCellID . AssociatedHeaderCellID Если свойство ссылается на TableHeaderCell то, что не удается найти, HttpException создается исключение.
Этот AddAttributesToRender метод используется главным образом разработчиками TableCell элементов управления, расширяющими функциональные возможности элемента управления.
Примечания для тех, кто наследует этот метод
При переопределении AddAttributesToRender(HtmlTextWriter) метода в производном классе обязательно вызовите AddAttributesToRender(HtmlTextWriter) метод базового класса, чтобы TableCell атрибуты элемента управления правильно отображались.