Button.RenderContents(HtmlTextWriter) Method
Definition
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.
Renders the contents of the control to the specified writer.
protected:
override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected override void RenderContents (System.Web.UI.HtmlTextWriter writer);
protected internal override void RenderContents (System.Web.UI.HtmlTextWriter writer);
override this.RenderContents : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub RenderContents (writer As HtmlTextWriter)
Protected Friend Overrides Sub RenderContents (writer As HtmlTextWriter)
Parameters
- writer
- HtmlTextWriter
A HtmlTextWriter object that represents the output stream to render HTML content on the client.
Examples
The following code example demonstrates how to override the RenderContents method in a custom server control so that it always displays text following a custom Button server control.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!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 Button - RenderContents - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom Button - RenderContents - C# Example</h3>
<aspSample:CustomButtonRenderContents
id="Button1"
runat="server"
Text="Button" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page language="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>
<title>Custom Button - RenderContents - VB.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom Button - RenderContents - VB.NET Example</h3>
<aspSample:CustomButtonRenderContents id="Button1" runat="server" Text="Button" />
</form>
</body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomButtonRenderContents : System.Web.UI.WebControls.Button
{
protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
{
// Call the base RenderContents method.
base.RenderContents(writer);
// Append some text after the button.
writer.Write("<br>Click this button for more information.");
}
}
}
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomButtonRenderContents
Inherits System.Web.UI.WebControls.Button
Protected Overrides Sub RenderContents(ByVal writer As System.Web.UI.HtmlTextWriter)
MyBase.RenderContents(writer)
' Append some text after the button.
writer.Write("<br>Click this button for more information.")
End Sub
End Class
End Namespace