HttpServerUtility.Execute Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.
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
Exceções
A corrente HttpContext é null.
-ou-
Ocorreu um erro durante a execução do handler especificado por path.
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.
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
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
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.