HttpRuntime Classe

Definição

Fornece um conjunto de ASP.NET serviços de tempo de execução 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 objeto HttpRuntime é usado no início do modelo de pipeline ASP.NET que processa solicitações HTTP. O método ProcessRequest 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

Nome Description
HttpRuntime()

Inicializa uma nova instância da classe HttpRuntime.

Propriedades

Nome Description
AppDomainAppId

Obtém a identificação do aplicativo do domínio do aplicativo onde ele HttpRuntime existe.

AppDomainAppPath

Obtém o caminho da unidade física do diretório do aplicativo para o aplicativo hospedado no domínio do 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 de domínio do domínio do aplicativo no qual a HttpRuntime instância existe.

AspClientScriptPhysicalPath

Obtém o caminho da pasta para os arquivos de script do cliente ASP.NET.

AspClientScriptVirtualPath

Obtém o caminho virtual para os arquivos de script do cliente ASP.NET.

AspInstallDirectory

Obtém o caminho físico do diretório em que os arquivos executáveis 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 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 ASP.NET armazena arquivos temporários (fontes geradas, assemblies compilados e assim por diante) para o aplicativo atual.

IISVersion

Obtém a versão do IIS que está hospedando este aplicativo.

IsOnUNCShare

Obtém um valor que indica se o aplicativo é mapeado para um compartilhamento UNC (convenção de nomenclatura universal).

MachineConfigurationDirectory

Obtém o caminho físico para o diretório em que o arquivo Machine.config do 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 IServiceProvider instância para suporte à injeção de dependência.

Métodos

Nome Description
Close()

Desliga a HttpRuntime instância.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetNamedPermissionSet()

Retorna o conjunto de permissões associadas a grupos de códigos.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ProcessRequest(HttpWorkerRequest)

Conduz toda ASP.NET execução de processamento da Web.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
UnloadAppDomain()

Encerra o aplicativo atual. O aplicativo reinicia na próxima vez que uma solicitação for recebida para ele.

Aplica-se a

Confira também