TableCell.AddAttributesToRender-Methode

Artikel
08/20/2007

Fügt der Liste der wiederzugebenden Attribute Eigenschaften hinzu, die für das TableCell-Steuerelement spezifisch sind.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overrides Sub AddAttributesToRender ( _
    writer As HtmlTextWriter _
)
'Usage
Dim writer As HtmlTextWriter

Me.AddAttributesToRender(writer)

protected override void AddAttributesToRender (
    HtmlTextWriter writer
)

protected:
virtual void AddAttributesToRender (
    HtmlTextWriter^ writer
) override

protected void AddAttributesToRender (
    HtmlTextWriter writer
)

protected override function AddAttributesToRender (
    writer : HtmlTextWriter
)

Parameter

writer
Der Ausgabestream, der HTML-Inhalt für den Client wiedergibt.

Ausnahmen

Ausnahmetyp	Bedingung
HttpException	Es wurde keine als zugeordnete Headerzelle aufgelistete Zelle gefunden.

Hinweise

Die AddAttributesToRender-Methode überschreibt die AddAttributesToRender-Methode der Basisklasse und ruft zuerst die Basismethode auf. Anschließend fügt sie die den Eigenschaften RowSpan, ColumnSpan und AssociatedHeaderCellID entsprechenden TableCell-Attribute hinzu. Wenn die AssociatedHeaderCellID-Eigenschaft auf eine TableHeaderCell verweist, die nicht gefunden werden kann, wird eine HttpException ausgelöst.

Die AddAttributesToRender-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des TableCell-Steuerelements verwendet.

Hinweise für Erben Wenn Sie die AddAttributesToRender-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie die AddAttributesToRender-Methode der Basisklasse aufrufen, damit die Attribute des TableCell-Steuerelements korrekt wiedergegeben werden.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der AddAttributesToRender-Methode in einem benutzerdefinierten Serversteuerelement veranschaulicht, sodass für jede Zelle ein benutzerdefiniertes Title-Attribut wiedergegeben wird.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - AddAttributesToRender - VB.NET Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TableCell - AddAttributesToRender - VB.NET 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>
        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - AddAttributesToRender - C# Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <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>
      
        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<html>
    <head>
        <title>Custom TableCell - AddAttributesToRender - VJ# Example</title>
  </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TableCell - AddAttributesToRender - VJ# 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>
      
        </form>
    </body>
</html>

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

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

    }
  }
}

package Samples.AspNet.JSL.Controls; 

public class CustomTableCellAddAttributesToRender
    extends System.Web.UI.WebControls.TableCell
{
    protected void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer)
    {
        // Write a Title attribute.
        writer.AddAttribute("title", "CustomAddAttributesToRender");

        // Call the base AddAttributesToRender method.
        super.AddAttributesToRender(writer);
    } 

}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TableCell-Klasse
TableCell-Member
System.Web.UI.WebControls-Namespace
RowSpan
ColumnSpan
AssociatedHeaderCellID

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente

Freigeben über