HttpResponse.ApplyAppPathModifier(String) Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Adds a session ID to the virtual path if the session is using Cookieless session state and returns the combined path. If Cookieless session state is not used, ApplyAppPathModifier(String) returns the original virtual path.

public:
 System::String ^ ApplyAppPathModifier(System::String ^ virtualPath);

public string ApplyAppPathModifier (string virtualPath);

member this.ApplyAppPathModifier : string -> string

Public Function ApplyAppPathModifier (virtualPath As String) As String

Parameters

virtualPath

String

The virtual path to a resource.

Returns

String

The virtualPath with the session ID inserted.

Examples

The following example declares a string variable named urlConverted, and sets it to the result of an ApplyAppPathModifier method call. The code then passes the variable's value to a HyperLink control's NavigateUrl property.

// Declare a string variable and set it to the result
// of a call to the ApplyAppPathModifier method.
// Then set the NavigateUrl property of a Hyperlink control
// to the string's value.
string urlConverted = Response.ApplyAppPathModifier("TestPage.aspx");
hlTest1.NavigateUrl = urlConverted;

' Declare a string variable and set it to the result
' of a call to the ApplyAppPathModifier method.
' Then set the NavigateUrl property of a Hyperlink control
' to the string's value.
Dim urlConverted As String = Response.ApplyAppPathModifier("TestPage.aspx")
hlTest1.NavigateUrl = urlConverted

Remarks

ApplyAppPathModifier is used only with cookieless sessions to construct absolute HREFs.