HttpServerUtilityBase.Execute Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

When overridden in a derived class, 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)	When overridden in a derived class, executes the handler for the specified virtual path in the context of the current process.
Execute(String, Boolean)	When overridden in a derived class, 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)	When overridden in a derived class, 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)	When overridden in a derived class, 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)	When overridden in a derived class, 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)

When overridden in a derived class, executes the handler for the specified virtual path in the context of the current process.

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

public virtual void Execute (string path);

abstract member Execute : string -> unit
override this.Execute : string -> unit

Public Overridable Sub Execute (path As String)

Parameters

path

String

The URL of the handler to execute.

Exceptions

NotImplementedException

Always.

Execute(String, Boolean)

When overridden in a derived class, 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:
 virtual void Execute(System::String ^ path, bool preserveForm);

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

abstract member Execute : string * bool -> unit
override this.Execute : string * bool -> unit

Public Overridable 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

NotImplementedException

Always.

Execute(String, TextWriter)

When overridden in a derived class, 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:
 virtual void Execute(System::String ^ path, System::IO::TextWriter ^ writer);

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

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

Public Overridable 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

NotImplementedException

Always.

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)

When overridden in a derived class, 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:
 virtual void Execute(System::String ^ path, System::IO::TextWriter ^ writer, bool preserveForm);

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

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

Public Overridable 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

NotImplementedException

Always.

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(IHttpHandler, TextWriter, Boolean)

When overridden in a derived class, 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:
 virtual void Execute(System::Web::IHttpHandler ^ handler, System::IO::TextWriter ^ writer, bool preserveForm);

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

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

Public Overridable 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

NotImplementedException

Always.

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.