HttpServerUtilityWrapper.Execute Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Executes the handler for a specified resource in the context of the current request and returns execution to the process that invoked it.

Overloads

Execute(String)	Executes the handler for the specified virtual path in the context of the current process.
Execute(String, Boolean)	Executes the handler for the specified virtual path in the context of the current process and specifies whether to clear the QueryString and Form collections.
Execute(String, TextWriter)	Executes the handler for the specified virtual path in the context of the current process, using a TextWriter instance to capture output from the executed handler.
Execute(String, TextWriter, Boolean)	Executes the handler for the specified virtual path in the context of the current request, using a TextWriter instance to capture output from the page and a value that indicates whether to clear the QueryString and Form collections.
Execute(IHttpHandler, TextWriter, Boolean)	Executes the specified handler in the context of the current process, using a TextWriter instance to capture output from the executed handler and a value that specifies whether to clear the QueryString and Form collections.

Execute(String)

Executes the handler for the specified virtual path in the context of the current process.

public:
 override void Execute(System::String ^ path);

public override void Execute (string path);

override this.Execute : string -> unit

Public Overrides Sub Execute (path As String)

Parameters

path

String

The URL of the handler to execute.

Exceptions

HttpException

The current HttpContext object is null.

-or-

An error occurred when the handler specified by path was executed.

ArgumentNullException

path is null.

-or-

path is not a virtual path.

Execute(String, Boolean)

Executes the handler for the specified virtual path in the context of the current process and specifies whether to clear the QueryString and Form collections.

public:
 override void Execute(System::String ^ path, bool preserveForm);

public override void Execute (string path, bool preserveForm);

override this.Execute : string * bool -> unit

Public Overrides Sub Execute (path As String, preserveForm As Boolean)

Parameters

path

String

The URL of the handler to execute.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Exceptions

HttpException

The current HttpContext object is null.

-or-

An error occurred when the handler specified by path was executed.

ArgumentNullException

path is null.

-or-

path is not a virtual path.

Execute(String, TextWriter)

Executes the handler for the specified virtual path in the context of the current process, using a TextWriter instance to capture output from the executed handler.

public:
 override void Execute(System::String ^ path, System::IO::TextWriter ^ writer);

public override void Execute (string path, System.IO.TextWriter writer);

override this.Execute : string * System.IO.TextWriter -> unit

Public Overrides Sub Execute (path As String, writer As TextWriter)

Parameters

path

String

The URL of the handler to execute.

writer

TextWriter

An object to capture the output.

Exceptions

HttpException

The current HttpContext is null.

-or-

An error occurred when the handler specified by path was executed.

ArgumentNullException

path is null.

-or-

path is not a virtual path.

Remarks

The writer parameter is passed by reference to the Execute method. To retrieve the output from the handler after the method completes, you use the properties and methods of the writer object. For an example, see Execute.

Execute(String, TextWriter, Boolean)

Executes the handler for the specified virtual path in the context of the current request, using a TextWriter instance to capture output from the page and a value that indicates whether to clear the QueryString and Form collections.

public:
 override void Execute(System::String ^ path, System::IO::TextWriter ^ writer, bool preserveForm);

public override void Execute (string path, System.IO.TextWriter writer, bool preserveForm);

override this.Execute : string * System.IO.TextWriter * bool -> unit

Public Overrides Sub Execute (path As String, writer As TextWriter, preserveForm As Boolean)

Parameters

path

String

The URL of the handler to execute.

writer

TextWriter

The object to capture the output.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Exceptions

HttpException

The current HttpContext instance is null.

-or-

path ends with a period (.).

-or-

An error occurred when the handler specified by path was executed.

ArgumentNullException

path is null.

ArgumentException

path is not a virtual path.

Execute(IHttpHandler, TextWriter, Boolean)

Executes the specified handler in the context of the current process, using a TextWriter instance to capture output from the executed handler and a value that specifies whether to clear the QueryString and Form collections.

public:
 override void Execute(System::Web::IHttpHandler ^ handler, System::IO::TextWriter ^ writer, bool preserveForm);

public override void Execute (System.Web.IHttpHandler handler, System.IO.TextWriter writer, bool preserveForm);

override this.Execute : System.Web.IHttpHandler * System.IO.TextWriter * bool -> unit

Public Overrides Sub Execute (handler As IHttpHandler, writer As TextWriter, preserveForm As Boolean)

Parameters

handler

IHttpHandler

The HTTP handler that implements the interface to transfer the current request to.

writer

TextWriter

The object to capture the output.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Exceptions

HttpException

An error occurred when the handler specified by handler was executed.

ArgumentNullException

The handler parameter is null.