PageAdapter.RenderPostBackEvent Method (HtmlTextWriter, String, String, String, String, String, String)

Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, an event target and argument, a previous-page parameter, and an access key.

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

public:
virtual void RenderPostBackEvent (
	HtmlTextWriter^ writer, 
	String^ target, 
	String^ argument, 
	String^ softkeyLabel, 
	String^ text, 
	String^ postUrl, 
	String^ accessKey
)
public void RenderPostBackEvent (
	HtmlTextWriter writer, 
	String target, 
	String argument, 
	String softkeyLabel, 
	String text, 
	String postUrl, 
	String accessKey
)
public function RenderPostBackEvent (
	writer : HtmlTextWriter, 
	target : String, 
	argument : String, 
	softkeyLabel : String, 
	text : String, 
	postUrl : String, 
	accessKey : String
)
Not applicable.

Parameters

writer

The HtmlTextWriter containing methods to render the target-specific output.

target

The String value holding the postback event target name.

argument

The String value holding the argument to pass to the postback target event.

softkeyLabel

The String value to use as a soft key label.

text

The String value of the text to display as the link.

postUrl

The String value holding the URL target page of the postback.

accessKey

The String value used to assign to the accessKey attribute of the created link.

The RenderPostBackEvent method writes a postback event as a scriptless hyperlink, including the possibly chunked UrlEncode view state, __EVENTTARGET=target, __EVENTARGUMENT=argument, __PREVIOUSPAGE=currentFilePath parameters, and an accessKey="accessKey" attribute.

View state is encrypted if the enableViewStateMac attribute of the pages Element (ASP.NET Settings Schema) configuration element is set to true.

Notes to Inheritors: When you inherit from the PageAdapter class, you can override the RenderPostBackEvent method if a different format is required for the postback event hyperlink or the browser has other unique requirements. For example, some browsers require the hyperlink text to be nonempty if the link is to render. You can also override RenderPostBackEvent if limited resources prevent including the view state as a URL parameter. The RenderPostBackEvent base method does not write an attribute for softkeyLabel.

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: