Edit

Share via


PageAdapter.RenderPostBackEvent Method

Definition

Renders a postback event into the response stream as a link, including all required arguments.

Overloads

RenderPostBackEvent(HtmlTextWriter, String, String, String, String)

Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, and event target and argument.

RenderPostBackEvent(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.

RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)

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

RenderPostBackEvent(HtmlTextWriter, String, String, String, String)

Renders a postback event into the response stream as a hyperlink, including the encoded and possibly encrypted view state, and event target and argument.

public:
 virtual void RenderPostBackEvent(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ target, System::String ^ argument, System::String ^ softkeyLabel, System::String ^ text);
public virtual void RenderPostBackEvent (System.Web.UI.HtmlTextWriter writer, string target, string argument, string softkeyLabel, string text);
abstract member RenderPostBackEvent : System.Web.UI.HtmlTextWriter * string * string * string * string -> unit
override this.RenderPostBackEvent : System.Web.UI.HtmlTextWriter * string * string * string * string -> unit
Public Overridable Sub RenderPostBackEvent (writer As HtmlTextWriter, target As String, argument As String, softkeyLabel As String, text As String)

Parameters

writer
HtmlTextWriter

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

target
String

The String value holding the postback event target name.

argument
String

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

softkeyLabel
String

The String value to use as a soft key label.

text
String

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

Remarks

The RenderPostBackEvent method writes a postback event as a scriptless hyperlink.

Notes to Inheritors

When you inherit from the PageAdapter class, you can override the RenderPostBackEvent(HtmlTextWriter, String, String, String, String) 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(HtmlTextWriter, String, String, String, String) if limited resources prevent including the view state as a URL parameter. The RenderPostBackEvent(HtmlTextWriter, String, String, String, String) base method does not write an attribute for softkeyLabel.

See also

Applies to

RenderPostBackEvent(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.

public:
 virtual void RenderPostBackEvent(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ target, System::String ^ argument, System::String ^ softkeyLabel, System::String ^ text, System::String ^ postUrl, System::String ^ accessKey);
public virtual void RenderPostBackEvent (System.Web.UI.HtmlTextWriter writer, string target, string argument, string softkeyLabel, string text, string postUrl, string accessKey);
abstract member RenderPostBackEvent : System.Web.UI.HtmlTextWriter * string * string * string * string * string * string -> unit
override this.RenderPostBackEvent : System.Web.UI.HtmlTextWriter * string * string * string * string * string * string -> unit
Public Overridable Sub RenderPostBackEvent (writer As HtmlTextWriter, target As String, argument As String, softkeyLabel As String, text As String, postUrl As String, accessKey As String)

Parameters

writer
HtmlTextWriter

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

target
String

The String value holding the postback event target name.

argument
String

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

softkeyLabel
String

The String value to use as a soft key label.

text
String

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

postUrl
String

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

accessKey
String

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

Remarks

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(HtmlTextWriter, String, String, String, String, String, String) 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(HtmlTextWriter, String, String, String, String, String, String) if limited resources prevent including the view state as a URL parameter. The RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String) base method does not write an attribute for softkeyLabel.

See also

Applies to

RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String, Boolean)

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

protected:
 void RenderPostBackEvent(System::Web::UI::HtmlTextWriter ^ writer, System::String ^ target, System::String ^ argument, System::String ^ softkeyLabel, System::String ^ text, System::String ^ postUrl, System::String ^ accessKey, bool encode);
protected void RenderPostBackEvent (System.Web.UI.HtmlTextWriter writer, string target, string argument, string softkeyLabel, string text, string postUrl, string accessKey, bool encode);
member this.RenderPostBackEvent : System.Web.UI.HtmlTextWriter * string * string * string * string * string * string * bool -> unit
Protected Sub RenderPostBackEvent (writer As HtmlTextWriter, target As String, argument As String, softkeyLabel As String, text As String, postUrl As String, accessKey As String, encode As Boolean)

Parameters

writer
HtmlTextWriter

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

target
String

The String value holding the postback event target name.

argument
String

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

softkeyLabel
String

The String value to use as a soft key label.

text
String

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

postUrl
String

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

accessKey
String

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

encode
Boolean

true to use & as the URL parameter separator; false to use &.

Remarks

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.

Notes to Inheritors

When you inherit from the PageAdapter class, you can override the RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String) 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(HtmlTextWriter, String, String, String, String, String, String) if limited resources prevent including view state as a URL parameter. The RenderPostBackEvent(HtmlTextWriter, String, String, String, String, String, String) base method does not write an attribute for softkeyLabel.

See also

Applies to