Compartilhar via

HttpServerUtility.Execute Método

  • Referência

Definição

Namespace:
System.Web
Assembly:
System.Web.dll

Executa o manipulador de um recurso especificado no contexto da solicitação atual e retorna a execução para a página que a invocou.

Sobrecargas

Execute(String)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual.
Execute(String, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual e especifica se é necessário limpar as coleções QueryString e Form.
Execute(String, TextWriter)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída do manipulador executado.
Execute(String, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída da página e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.
Execute(IHttpHandler, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída do manipulador executado e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.

Execute(String)

Executa o manipulador do caminho virtual especificado no contexto da solicitação 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 ser executada.

Exceções

HttpException

O HttpContext atual é null.

- ou - Ocorreu um erro ao executar o manipulador especificado por path.

ArgumentNullException

path é null.

- ou - path não é um caminho virtual.

Exemplos

O exemplo a seguir exibe a página .aspx "Updateinfo.aspx" no diretório atual. A execução do programa retorna à página inicial depois que a página Updateinfo.aspx é exibida.

Server.Execute("updateinfo.aspx");


Server.Execute("updateinfo.aspx")

Comentários

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

ASP.NET não verifica se o usuário atual está autorizado a exibir o recurso fornecido pelo Execute método. Embora a lógica de autorização e autenticação ASP.NET seja executada antes do manipulador de recursos original ser chamado, ASP.NET chama diretamente o manipulador indicado pelo Execute método e não executa novamente a lógica de autenticação e autorização para o novo recurso. Se a política de segurança do aplicativo exigir que os clientes tenham autorização apropriada para acessar o recurso, o aplicativo deverá forçar a reautorização ou fornecer um mecanismo personalizado de controle de acesso.

Você pode forçar a reautorização usando o Redirect método em vez do Execute método. Redirect executa um redirecionamento do lado do cliente no qual o navegador solicita o novo recurso. Como esse redirecionamento é uma nova solicitação que entra no sistema, ele está sujeito a toda a lógica de autenticação e autorização do IIS (Serviços de Informações da Internet) e ASP.NET política de segurança.

Você pode verificar se o usuário tem permissão para exibir o recurso incorporando um método de autorização personalizado que usa o IsInRole método antes que o aplicativo chame o Execute método.

Aplica-se a

Execute(String, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual e especifica se é necessário limpar as coleções QueryString 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 ser executada.

preserveForm
Boolean

true para preservar as coleções QueryString e Form; false para limpar as coleções QueryString e Form.

Exceções

HttpException

O HttpContext atual é null.

- ou - Ocorreu um erro ao executar o manipulador especificado por path.

ArgumentNullException

path é null.

- ou - path não é um caminho virtual.

Exemplos

O exemplo a seguir mostra como executar a página Updateinfo.aspx .aspx na solicitação atual e preservar as coleções e Form as QueryString coleções. A execução do programa retorna à página inicial após Updateinfo.aspx a exibição.

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

Confira também

Aplica-se a

Execute(String, TextWriter)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um 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 ser executada.

writer
TextWriter

O TextWriter para capturar a saída.

Exceções

HttpException

O HttpContext atual é null.

- ou - Ocorreu um erro ao executar o manipulador especificado por path.

ArgumentNullException

path é null.

- ou - path não é um caminho virtual.

Exemplos

O exemplo a seguir executa a Login.aspx página no servidor no diretório atual e recebe a saída da página por meio do StringWriter objeto writer. Ele grava o fluxo HTML recebido do fluxo de writer 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())

Comentários

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

ASP.NET não verifica se o usuário atual está autorizado a exibir o recurso fornecido pelo Execute método. Embora a lógica de autorização e autenticação ASP.NET seja executada antes do manipulador de recursos original ser chamado, ASP.NET chama diretamente o manipulador indicado pelo Execute método e não executa novamente a lógica de autenticação e autorização para o novo recurso. Se a política de segurança do aplicativo exigir que os clientes tenham autorização apropriada para acessar o recurso, o aplicativo deverá forçar a reautorização ou fornecer um mecanismo personalizado de controle de acesso.

Você pode forçar a reautorização usando o Redirect método em vez do Execute método. Redirect executa um redirecionamento do lado do cliente no qual o navegador solicita o novo recurso. Como esse redirecionamento é uma nova solicitação que entra no sistema, ele está sujeito a toda a lógica de autenticação e autorização do IIS (Serviços de Informações da Internet) e ASP.NET política de segurança.

Você pode verificar se o usuário tem permissão para exibir o recurso incorporando um método de autorização personalizado que usa o IsInRole método antes que o aplicativo chame o Execute método.

Confira também

Aplica-se a

Execute(String, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída da página e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.

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 ser executada.

writer
TextWriter

O TextWriter para capturar a saída.

preserveForm
Boolean

true para preservar as coleções QueryString e Form; false para limpar as coleções QueryString e Form.

Exceções

HttpException

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

- ou - path termina com um ponto (.).

- ou - Ocorreu um erro ao executar o manipulador especificado por path.

ArgumentNullException

path é null.

ArgumentException

path não é um caminho virtual.

Exemplos

O exemplo a seguir executa a Login.aspx página no servidor no diretório atual e recebe a saída da página por meio do StringWriter objeto writer. Ele grava o fluxo HTML recebido do fluxo de writer saída HTTP. O conteúdo do e QueryString das Form coleções são preservados.

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

Comentários

O Execute método continua a execução da solicitação original após a conclusão da execução do caminho virtual especificado. O Transfer método transfere incondicionalmente a execução para outro manipulador.

ASP.NET não verifica se o usuário atual está autorizado a exibir o recurso fornecido pelo Execute método. Embora a lógica de autorização e autenticação ASP.NET seja executada antes do manipulador de recursos original ser chamado, ASP.NET chama diretamente o manipulador indicado pelo Execute método e não executa novamente a lógica de autenticação e autorização para o novo recurso. Se a política de segurança do aplicativo exigir que os clientes tenham autorização apropriada para acessar o recurso, o aplicativo deverá forçar a reautorização ou fornecer um mecanismo personalizado de controle de acesso.

Você pode forçar a reautorização usando o Redirect método em vez do Execute método. Redirect executa um redirecionamento do lado do cliente no qual o navegador solicita o novo recurso. Como esse redirecionamento é uma nova solicitação que entra no sistema, ele está sujeito a toda a lógica de autenticação e autorização do IIS (Serviços de Informações da Internet) e ASP.NET política de segurança.

Você pode verificar se o usuário tem permissão para exibir o recurso incorporando um método de autorização personalizado que usa o IsInRole método antes que o aplicativo chame o Execute método.

Confira também

Aplica-se a

Execute(IHttpHandler, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída do manipulador executado e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.

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 manipulador HTTP que implementa o IHttpHandler para o qual a solicitação atual será transferida.

writer
TextWriter

O TextWriter para capturar a saída.

preserveForm
Boolean

true para preservar as coleções QueryString e Form; false para limpar as coleções QueryString e Form.

Exceções

HttpException

Ocorreu um erro ao executar o manipulador especificado por handler.

ArgumentNullException

O parâmetro handler é null.

Comentários

Você pode escrever manipuladores HTTP personalizados para processar tipos específicos e predefinidos de solicitações HTTP em qualquer idioma que esteja em conformidade com a CLS (Common Language Specification). Código executável que é definido nas classes de manipulador HTTP em vez de páginas ASP convencionais (também conhecidas como ASP clássicas) ou páginas ASP.NET responde a essas solicitações específicas. Os manipuladores HTTP permitem interagir com os serviços de solicitação e resposta de baixo nível de um servidor Web que está executando Serviços de Informações da Internet (IIS) e fornecem funcionalidade semelhante às extensões ISAPI, mas com um modelo de programação mais simples.

ASP.NET não verifica se o usuário atual está autorizado a exibir o recurso que é entregue pelo Execute método. Embora a lógica de autorização e autenticação ASP.NET seja executada antes do manipulador de recursos original ser chamado, ASP.NET chama diretamente o manipulador indicado pelo Execute método e não executa novamente a lógica de autenticação e autorização para o novo recurso. Se a política de segurança do aplicativo exigir que os clientes tenham autorização apropriada para obter acesso ao recurso, o aplicativo deverá forçar a reautorização ou fornecer um mecanismo personalizado de controle de acesso.

Você pode forçar a reautorização usando o Redirect método em vez do Execute método. Executa Redirect um redirecionamento do lado do cliente no qual o navegador solicita o novo recurso. Como esse redirecionamento é uma nova solicitação que entra no sistema, ele é submetido a toda a lógica de autenticação e autorização do IIS e da política de segurança ASP.NET.

Você pode verificar se o usuário tem permissão para exibir o recurso incorporando um método de autorização personalizado que usa o IsInRole método antes que o aplicativo chame o Execute método.

Confira também

Aplica-se a