HttpRuntime Classe

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Fornece um conjunto de serviços de execução ASP.NET para a aplicação atual.

public ref class HttpRuntime sealed
public sealed class HttpRuntime
type HttpRuntime = class
Public NotInheritable Class HttpRuntime
Herança
Object
HttpRuntime

Exemplos

O exemplo seguinte demonstra como obter propriedades da HttpRuntime classe que representa o domínio de aplicação atual e exibi-las ao 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>

Observações

O objeto HttpRuntime é usado no início do modelo de pipeline ASP.NET que processa pedidos HTTP. O método ProcessRequest gere todo o processamento Web ASP.NET subsequente.

Os programadores de páginas podem usar as propriedades da HttpRuntime classe para obter informações sobre o domínio de aplicação atual para fins de diagnóstico, por exemplo. Os programadores que criam pipeline de processos personalizados ou um ambiente de alojamento personalizado devem chamar o ProcessRequest método a partir de uma classe derivada da HttpWorkerRequest classe ou SimpleWorkerRequest .

Construtores

Name Description
HttpRuntime()

Inicializa uma nova instância da HttpRuntime classe.

Propriedades

Name Description
AppDomainAppId

Obtém a identificação de aplicação do domínio de aplicação onde existe.HttpRuntime
AppDomainAppPath

Obtém o caminho físico do diretório de aplicação para a aplicação alojada no domínio de aplicação atual.
AppDomainAppVirtualPath

Obtém o caminho virtual do diretório que contém a aplicação alojada no domínio de aplicação atual.
AppDomainId

Obtém a identificação do domínio da aplicação onde a HttpRuntime instância existe.
AspClientScriptPhysicalPath

Obtém o caminho da pasta para os ficheiros de script cliente ASP.NET.
AspClientScriptVirtualPath

Obtém o caminho virtual para os ficheiros de script cliente ASP.NET.
AspInstallDirectory

Obtém o caminho físico do diretório onde os ficheiros executáveis do ASP.NET estão instalados.
BinDirectory

Obtém o caminho físico para o diretório /bin da aplicação atual.
Cache

Obtém-nos Cache para a aplicação atual.
ClrInstallDirectory

Obtém o caminho físico para o diretório onde estão instalados os ficheiros executáveis em linguagem comum de execução.
CodegenDir

Obtém o caminho físico para o diretório onde o ASP.NET armazena ficheiros temporários (fontes geradas, assemblies compilados, etc.) para a aplicação atual.
IISVersion

Recebe a versão do IIS que está a hospedar esta aplicação.
IsOnUNCShare

Recebe um valor que indica se a aplicação está mapeada para uma partilha de convenção universal de nomenclatura (UNC).
MachineConfigurationDirectory

Obtém o caminho físico para o diretório onde está localizado o ficheiro Machine.config da aplicação atual.
TargetFramework

Obtém a versão do .NET Framework que a aplicação web atual atinge.
UsingIntegratedPipeline

Obtém um valor que indica se a aplicação atual está a correr no modo de pipeline integrado do IIS 7.0.
WebObjectActivator

Obtém ou define a IServiceProvider instância para suporte à injeção de dependências.

Métodos

Name Description
Close()

Desliga a HttpRuntime instância.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetNamedPermissionSet()

Devolve o conjunto de permissões associadas aos grupos de código.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ProcessRequest(HttpWorkerRequest)

Gere toda a execução do processamento Web do ASP.NET.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
UnloadAppDomain()

Termina a candidatura atual. A candidatura reinicia na próxima vez que for recebido um pedido.

Aplica-se a

Ver também