HttpRuntime Classe

Referência

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece um conjunto de serviços de tempo de execução do ASP.NET para o aplicativo atual.

public ref class HttpRuntime sealed

public sealed class HttpRuntime

type HttpRuntime = class

Public NotInheritable Class HttpRuntime

Herança: Object
HttpRuntime

Exemplos

O exemplo a seguir demonstra como obter propriedades da HttpRuntime classe que representa o domínio do aplicativo atual e exibi-las no navegador.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, System.EventArgs e)
  {
    StringBuilder sb = new StringBuilder();
    String nl = "<br />";

    sb.Append("AppDomainAppId = " + 
      HttpRuntime.AppDomainAppId + nl);
    sb.Append("AppDomainAppPath = " + 
      HttpRuntime.AppDomainAppPath + nl);
    sb.Append("AppDomainAppVirtualPath = " + 
      HttpRuntime.AppDomainAppVirtualPath + nl);
    sb.Append("AppDomainId = " + 
      HttpRuntime.AppDomainId + nl);
    sb.Append("AspInstallDirectory = " + 
      HttpRuntime.AspInstallDirectory + nl);
    sb.Append("BinDirectory = " + 
      HttpRuntime.BinDirectory + nl);
    sb.Append("ClrInstallDirectory = " + 
      HttpRuntime.ClrInstallDirectory + nl);
    sb.Append("CodegenDir = " + 
      HttpRuntime.CodegenDir + nl);
    sb.Append("IsOnUNCShare = " + 
      HttpRuntime.IsOnUNCShare.ToString() + nl);
    sb.Append("MachineConfigurationDirectory = " + 
      HttpRuntime.MachineConfigurationDirectory + nl);

    label1.Text = sb.ToString();
  }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HttpRuntime Example</title>
  </head>
  <body>    
    <form id="form1" runat="server">
      <asp:label id="label1" runat="server"/>
    </form>
  </body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    Dim sb As New StringBuilder()
    Dim nl As String = "<br />"

    sb.Append("AppDomainAppId = " & _
      HttpRuntime.AppDomainAppId & nl)
    sb.Append("AppDomainAppPath = " & _
      HttpRuntime.AppDomainAppPath & nl)
    sb.Append("AppDomainAppVirtualPath = " & _
      HttpRuntime.AppDomainAppVirtualPath & nl)
    sb.Append("AppDomainId = " & _
      HttpRuntime.AppDomainId & nl)
    sb.Append("AspInstallDirectory = " & _
      HttpRuntime.AspInstallDirectory & nl)
    sb.Append("BinDirectory = " & _
      HttpRuntime.BinDirectory & nl)
    sb.Append("ClrInstallDirectory = " & _
      HttpRuntime.ClrInstallDirectory & nl)
    sb.Append("CodegenDir = " & _
      HttpRuntime.CodegenDir & nl)
    sb.Append("IsOnUNCShare = " & _
      HttpRuntime.IsOnUNCShare.ToString() & nl)
    sb.Append("MachineConfigurationDirectory = " & _
      HttpRuntime.MachineConfigurationDirectory & nl)

    label1.Text = sb.ToString()

  End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HttpRuntime Example</title>
  </head>
  <body>    
    <form id="Form1" runat="server">
      <asp:label id="label1" runat="server"/>
    </form>
  </body>
</html>

Comentários

O HttpRuntime objeto é usado no início do modelo de pipeline ASP.NET que processa solicitações HTTP. O ProcessRequest método conduz todo o processamento da Web ASP.NET subsequente.

Os desenvolvedores de página podem usar as propriedades de HttpRuntime classe para descobrir informações sobre o domínio do aplicativo atual para fins de diagnóstico, por exemplo. Os desenvolvedores que criam um pipeline de processo personalizado ou um ambiente de hospedagem personalizado devem chamar o ProcessRequest método de uma classe derivada da classe ou SimpleWorkerRequest da HttpWorkerRequest classe.

Construtores

HttpRuntime()

Inicializa uma nova instância da classe HttpRuntime.

Propriedades

AppDomainAppId	Obtém a identificação do aplicativo do domínio do aplicativo no qual o HttpRuntime está localizado.
AppDomainAppPath	Obtém o caminho do disco físico do diretório do aplicativo para o aplicativo hospedado no domínio de aplicativo atual.
AppDomainAppVirtualPath	Obtém o caminho virtual do diretório que contém o aplicativo hospedado no domínio do aplicativo atual.
AppDomainId	Obtém a identificação do domínio do aplicativo no qual a instância de HttpRuntime está localizada.
AspClientScriptPhysicalPath	Obtém o caminho da pasta para os arquivos de script de cliente do ASP.NET.
AspClientScriptVirtualPath	Obtém o caminho virtual para os arquivos de script de cliente do ASP.NET.
AspInstallDirectory	Obtém o caminho físico do diretório em que os arquivos executáveis do ASP.NET estão instalados.
BinDirectory	Obtém o caminho físico para o diretório /bin do aplicativo atual.
Cache	Obtém o Cache para o aplicativo atual.
ClrInstallDirectory	Obtém o caminho físico para o diretório em que os arquivos executáveis do Common Language Runtime estão instalados.
CodegenDir	Obtém o caminho físico para o diretório em que o ASP.NET armazena arquivos temporários (fontes geradas, assemblies compilados e assim por diante) do aplicativo atual.
IISVersion	Obtém a versão do IIS que está hospedando esse aplicativo.
IsOnUNCShare	Obtém um valor que indica se o aplicativo é mapeado para um compartilhamento UNC.
MachineConfigurationDirectory	Obtém o caminho físico para o diretório em que o arquivo Machine.config para o aplicativo atual está localizado.
TargetFramework	Obtém a versão do .NET Framework que o aplicativo Web atual visa.
UsingIntegratedPipeline	Obtém um valor que indica se o aplicativo atual está em execução no modo de pipeline integrado do IIS 7.0.
WebObjectActivator	Obtém ou define a instância de IServiceProvider para suporte à injeção de dependência.

Métodos

Close()	Desliga a instância de HttpRuntime.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetNamedPermissionSet()	Retorna o conjunto de permissões associadas a grupos de código.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ProcessRequest(HttpWorkerRequest)	Conduz toda a execução de processamento da Web do ASP.NET.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UnloadAppDomain()	Encerra o aplicativo atual. O aplicativo será reiniciado na próxima vez em que uma solicitação for recebida para ele.

Aplica-se a