HttpRuntime Classe

Definição

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
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

Confira também