HttpServerUtility.Execute Método

Definição

Executa o handler para um recurso especificado no contexto do pedido atual e devolve a execução à página que o invocou.

Sobrecargas

Name Description
Execute(String)

Executa o handler para o caminho virtual especificado no contexto do pedido atual.

Execute(String, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual e especifica se deve limpar as QueryString coleções e Form .

Execute(String, TextWriter)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do manipulador executado.

Execute(String, TextWriter, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída da página e um parâmetro booleano especifica se deve apagar as QueryString coleções e Form .

Execute(IHttpHandler, TextWriter, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do handler executado e um parâmetro booleano especifica se deve limpar as QueryString coleções e Form .

Execute(String)

Executa o handler para o caminho virtual especificado no contexto do pedido atual.

public:
 void Execute(System::String ^ path);
public void Execute(string path);
member this.Execute : string -> unit
Public Sub Execute (path As String)

Parâmetros

path
String

O caminho da URL a executar.

Exceções

A corrente HttpContext é null.

-ou-

Ocorreu um erro durante a execução do handler especificado por path.

path é null.

-ou-

path não é um caminho virtual.

Exemplos

O exemplo seguinte mostra a página de .aspx "Updateinfo.aspx" no diretório atual. A execução do programa regressa à página inicial após a exibição da página Updateinfo.aspx.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")
   

Observações

O Execute método continua a execução da página original após a conclusão da nova página. O Transfer método transfere a execução incondicionalmente para outro handler.

ASP.NET não verifica se o utilizador atual está autorizado a visualizar o recurso fornecido pelo método Execute. Embora a lógica de autorização e autenticação de ASP.NET seja executada antes de o handler de recursos original ser chamado, ASP.NET chama diretamente o handler indicado pelo método Execute e não reexecuta a lógica de autenticação e autorização para o novo recurso. Se a política de segurança da sua aplicação exigir que os clientes tenham autorização adequada para aceder ao recurso, a aplicação deve forçar a reautorização ou fornecer um mecanismo personalizado de controlo de acesso.

Pode forçar a reautorização usando o Redirect método em vez do método Execute . Redirect realiza um redirecionamento do lado do cliente em que o navegador solicita o novo recurso. Como este redirecionamento é um novo pedido que entra no sistema, está sujeito a toda a lógica de autenticação e autorização tanto da política de segurança do Serviços de Informação Internet (IIS) como da ASP.NET.

Pode verificar se o utilizador tem permissão para visualizar o recurso incorporando um método de autorização personalizado que utiliza o IsInRole método antes de a aplicação chamar o Execute método.

Aplica-se a

Execute(String, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual e especifica se deve limpar as QueryString coleções e Form .

public:
 void Execute(System::String ^ path, bool preserveForm);
public void Execute(string path, bool preserveForm);
member this.Execute : string * bool -> unit
Public Sub Execute (path As String, preserveForm As Boolean)

Parâmetros

path
String

O caminho da URL a executar.

preserveForm
Boolean

para preservar as coleções e &; para limpar as coleções e colecções.

Exceções

A corrente HttpContext é null.

-ou-

Ocorreu um erro durante a execução do handler especificado por path.

path é null.

-ou-

path não é um caminho virtual.

Exemplos

O exemplo seguinte mostra como executar a página Updateinfo.aspx .aspx no pedido atual e preservar as QueryString coleções e.Form A execução do programa retorna à página inicial depois Updateinfo.aspx de ser exibida.

private void Page_Load(Object sender, EventArgs e)
{
    Server.Execute("updateinfo.aspx", true);
} 
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Server.Execute("updateinfo.aspx", True)
End Sub

Ver também

Aplica-se a

Execute(String, TextWriter)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do manipulador executado.

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer);
public void Execute(string path, System.IO.TextWriter writer);
member this.Execute : string * System.IO.TextWriter -> unit
Public Sub Execute (path As String, writer As TextWriter)

Parâmetros

path
String

O caminho da URL a executar.

writer
TextWriter

O TextWriter para captar a saída.

Exceções

A corrente HttpContext é null.

-ou-

Ocorreu um erro durante a execução do handler especificado por path.

path é null.

-ou-

path não é um caminho virtual.

Exemplos

O exemplo seguinte executa a Login.aspx página no servidor no diretório atual e recebe a saída da página através do StringWriter objeto writer. Escreve o fluxo HTML recebido writer para o fluxo de saída HTTP.

StringWriter writer = new StringWriter();
Server.Execute("Login.aspx", writer);
Response.Write("<H3>Please Login:</H3><br>"+ writer.ToString());

Dim writer As New StringWriter
Server.Execute("Login.aspx", writer)
Response.Write("<H3>Please Login:</H3><br>" & writer.ToString())
   

Observações

O Execute método continua a execução do pedido original após a execução do caminho virtual especificado estar concluída. O Transfer método transfere a execução incondicionalmente para outro handler.

ASP.NET não verifica se o utilizador atual está autorizado a visualizar o recurso fornecido pelo método Execute. Embora a lógica de autorização e autenticação de ASP.NET seja executada antes de o handler de recursos original ser chamado, ASP.NET chama diretamente o handler indicado pelo método Execute e não reexecuta a lógica de autenticação e autorização para o novo recurso. Se a política de segurança da sua aplicação exigir que os clientes tenham autorização adequada para aceder ao recurso, a aplicação deve forçar a reautorização ou fornecer um mecanismo personalizado de controlo de acesso.

Pode forçar a reautorização usando o Redirect método em vez do método Execute . Redirect realiza um redirecionamento do lado do cliente em que o navegador solicita o novo recurso. Como este redirecionamento é um novo pedido que entra no sistema, está sujeito a toda a lógica de autenticação e autorização tanto da política de segurança do Serviços de Informação Internet (IIS) como da ASP.NET.

Pode verificar se o utilizador tem permissão para visualizar o recurso incorporando um método de autorização personalizado que utiliza o IsInRole método antes de a aplicação chamar o Execute método.

Ver também

Aplica-se a

Execute(String, TextWriter, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída da página e um parâmetro booleano especifica se deve apagar as QueryString coleções e Form .

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer, bool preserveForm);
public void Execute(string path, System.IO.TextWriter writer, bool preserveForm);
member this.Execute : string * System.IO.TextWriter * bool -> unit
Public Sub Execute (path As String, writer As TextWriter, preserveForm As Boolean)

Parâmetros

path
String

O caminho da URL a executar.

writer
TextWriter

O TextWriter para captar a saída.

preserveForm
Boolean

para preservar as coleções e &; para limpar as coleções e colecções.

Exceções

O atual HttpContext é uma referência nula (Nothing em Visual Basic).

-ou-

path termina com um ponto (.).

-ou-

Ocorreu um erro durante a execução do handler especificado por path.

path é null.

path não é um caminho virtual.

Exemplos

O exemplo seguinte executa a Login.aspx página no servidor no diretório atual e recebe a saída da página através do StringWriter objeto writer. Escreve o fluxo HTML recebido writer para o fluxo de saída HTTP. O conteúdo das Form coleções QueryString e está preservado.

private void Page_Load(Object sender, EventArgs e)
{
    System.IO.StringWriter writer = new System.IO.StringWriter();
    Server.Execute("Login.aspx", writer, true);
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString());
} 
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Dim writer As System.IO.StringWriter = New System.IO.StringWriter()
    Server.Execute("Login.aspx", writer, True)
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString())
End Sub

Observações

O Execute método continua a execução do pedido original após a execução do caminho virtual especificado estar concluída. O Transfer método transfere a execução incondicionalmente para outro handler.

ASP.NET não verifica se o utilizador atual está autorizado a visualizar o recurso fornecido pelo método Execute. Embora a lógica de autorização e autenticação de ASP.NET seja executada antes de o handler de recursos original ser chamado, ASP.NET chama diretamente o handler indicado pelo método Execute e não reexecuta a lógica de autenticação e autorização para o novo recurso. Se a política de segurança da sua aplicação exigir que os clientes tenham autorização adequada para aceder ao recurso, a aplicação deve forçar a reautorização ou fornecer um mecanismo personalizado de controlo de acesso.

Pode forçar a reautorização usando o Redirect método em vez do método Execute . Redirect realiza um redirecionamento do lado do cliente em que o navegador solicita o novo recurso. Como este redirecionamento é um novo pedido que entra no sistema, está sujeito a toda a lógica de autenticação e autorização tanto da política de segurança do Serviços de Informação Internet (IIS) como da ASP.NET.

Pode verificar se o utilizador tem permissão para visualizar o recurso incorporando um método de autorização personalizado que utiliza o IsInRole método antes de a aplicação chamar o Execute método.

Ver também

Aplica-se a

Execute(IHttpHandler, TextWriter, Boolean)

Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do handler executado e um parâmetro booleano especifica se deve limpar as QueryString coleções e Form .

public:
 void Execute(System::Web::IHttpHandler ^ handler, System::IO::TextWriter ^ writer, bool preserveForm);
public void Execute(System.Web.IHttpHandler handler, System.IO.TextWriter writer, bool preserveForm);
member this.Execute : System.Web.IHttpHandler * System.IO.TextWriter * bool -> unit
Public Sub Execute (handler As IHttpHandler, writer As TextWriter, preserveForm As Boolean)

Parâmetros

handler
IHttpHandler

O handler HTTP que implementa o IHttpHandler para transferir o pedido atual para.

writer
TextWriter

O TextWriter para captar a saída.

preserveForm
Boolean

para preservar as coleções e &; para limpar as coleções e colecções.

Exceções

Ocorreu um erro durante a execução do handler especificado por handler.

O handler parâmetro é null.

Observações

Pode escrever manipuladores HTTP personalizados para processar tipos específicos e pré-definidos de pedidos HTTP em qualquer linguagem que esteja em conformidade com a Especificação de Linguagem Comum (CLS). Código executável definido nas classes de handler HTTP em vez de páginas ASP convencionais (também conhecidas como ASP clássico) ou páginas ASP.NET responde a estes pedidos específicos. Os manipuladores HTTP permitem interagir com os serviços de pedido e resposta de baixo nível de um servidor Web que executa o Serviços de Informação Internet (IIS), e fornecem funcionalidades semelhantes às extensões ISAPI, mas com um modelo de programação mais simples.

ASP.NET não verifica se o utilizador atual está autorizado a visualizar o recurso entregue pelo método Execute. Embora a lógica de autorização e autenticação ASP.NET seja executada antes de o handler original ser chamado, ASP.NET chama diretamente o handler indicado pelo método Execute e não reexecuta a lógica de autenticação e autorização para o novo recurso. Se a política de segurança da sua aplicação exigir que os clientes tenham a autorização adequada para aceder ao recurso, a aplicação deve forçar a reautorização ou fornecer um mecanismo personalizado de controlo de acesso.

Pode forçar a reautorização usando o Redirect método em vez do método Execute . Ele Redirect realiza um redirecionamento do lado do cliente em que o navegador solicita o novo recurso. Como este redirecionamento é um novo pedido que entra no sistema, está sujeito a toda a lógica de autenticação e autorização tanto da política de segurança do IIS como do ASP.NET.

Pode verificar se o utilizador tem permissão para visualizar o recurso incorporando um método de autorização personalizado que utiliza o IsInRole método antes de a aplicação chamar o Execute método.

Ver também

Aplica-se a