Panel.AddAttributesToRender(HtmlTextWriter) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds information about the background image, alignment, wrap, and direction to the list of attributes to render.

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)

Parameters

writer: HtmlTextWriter

An HtmlTextWriter that represents the output stream to render HTML content on the client.

Exceptions

InvalidOperationException

The DefaultButton property of the Panel control must be the ID of a control of type IButtonControl.

Examples

The following code example demonstrates how to override the AddAttributesToRender method in a custom server control so that the Panel text always displays as bold.

ASP.NET (C#)

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
        <title>Custom Panel - AddAttributesToRender - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Panel - AddAttributesToRender - C# Example</h3>
            
            <aspSample:CustomPanelAddAttributesToRender 
              id="Panel1" 
              runat="server" 
              BorderWidth="1px" 
              BorderStyle="Solid">
          <asp:Label id="Label1" runat="server">Label1</asp:Label>
      </aspSample:CustomPanelAddAttributesToRender>

        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
        <title>Custom Panel - AddAttributesToRender - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Panel - AddAttributesToRender - VB.NET Example</h3>
            
            <aspSample:CustomPanelAddAttributesToRender id="Panel1" runat="server" 
             BorderWidth="1px" BorderStyle="Solid">
                    <asp:Label id="Label1" runat="server">Label1</asp:Label>
            </aspSample:CustomPanelAddAttributesToRender>
        </form>
    </body>
</html>

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomPanelAddAttributesToRender : System.Web.UI.WebControls.Panel
  {
    protected override void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer)
    {
      // Show the Panel text as Bold 
      writer.AddStyleAttribute(System.Web.UI.HtmlTextWriterStyle.FontWeight, "bold");

      // Call the Base's AddAttributesToRender method.
      base.AddAttributesToRender(writer);
    }
  }
}

<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomPanelAddAttributesToRender
    Inherits System.Web.UI.WebControls.Panel

    Protected Overrides Sub AddAttributesToRender(ByVal writer As System.Web.UI.HtmlTextWriter)

        ' Show the Panel text as Bold 
        writer.AddStyleAttribute(System.Web.UI.HtmlTextWriterStyle.FontWeight, "bold")

        ' Call the Base's AddAttributesToRender method.
        MyBase.AddAttributesToRender(writer)
    End Sub
End Class

Remarks

The AddAttributesToRender method is used primarily by control developers.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via