HttpRuntime Classe

Definizione

Fornisce una serie di servizi di runtime ASP.NET per l'applicazione corrente.

public ref class HttpRuntime sealed
public sealed class HttpRuntime
type HttpRuntime = class
Public NotInheritable Class HttpRuntime
Ereditarietà
HttpRuntime

Esempio

Nell'esempio seguente viene illustrato come ottenere le proprietà della HttpRuntime classe che rappresenta il dominio applicazione corrente e visualizzarle nel browser.

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

Commenti

L'oggetto HttpRuntime viene usato all'inizio del modello di pipeline ASP.NET che elabora le richieste HTTP. Il ProcessRequest metodo determina tutte le ASP.NET successive elaborazione Web.

Gli sviluppatori di pagine possono usare le proprietà della HttpRuntime classe per trovare informazioni sul dominio applicazione corrente a scopo diagnostico, ad esempio. Gli sviluppatori che creano una pipeline di processo personalizzata o un ambiente di hosting personalizzato devono chiamare il ProcessRequest metodo da una classe derivata dalla HttpWorkerRequest classe o SimpleWorkerRequest .

Costruttori

HttpRuntime()

Inizializza una nuova istanza della classe HttpRuntime.

Proprietà

AppDomainAppId

Restituisce l'identificazione dell'applicazione del dominio applicazione in cui risiede l'oggetto HttpRuntime.

AppDomainAppPath

Restituisce il percorso dell'unità fisica della directory dell'applicazione presente nel dominio applicazione corrente.

AppDomainAppVirtualPath

Restituisce il percorso virtuale della directory che contiene l'applicazione presente nel dominio applicazione corrente.

AppDomainId

Ottiene l'identificazione del dominio applicazione in cui è presente l'istanza di HttpRuntime.

AspClientScriptPhysicalPath

Ottiene il percorso della cartella per i file script client ASP.NET.

AspClientScriptVirtualPath

Ottiene il percorso virtuale per i file script client ASP.NET.

AspInstallDirectory

Restituisce il percorso fisico della directory in cui sono installati i file eseguibili di ASP.NET.

BinDirectory

Restituisce il percorso fisico della directory /bin dell'applicazione corrente.

Cache

Restituisce l'oggetto Cache per l'applicazione corrente.

ClrInstallDirectory

Restituisce il percorso fisico della directory in cui sono installati i file eseguibili di Common Language Runtime.

CodegenDir

Restituisce il percorso fisico della directory in cui vengono archiviati da ASP.NET i file temporanei dell'applicazione corrente, come ad esempio il codice sorgente generato, gli assembly compilati e così via.

IISVersion

Ottiene la versione di IIS che ospita l'applicazione.

IsOnUNCShare

Restituisce un valore che indica se è stato eseguito il mapping dell'applicazione a una condivisione UNC (Universal Naming Convention).

MachineConfigurationDirectory

Restituisce il percorso fisico della directory in cui è presente il file Machine.config dell'applicazione corrente.

TargetFramework

Ottiene la versione di .NET Framework di destinazione per l'applicazione Web corrente.

UsingIntegratedPipeline

Ottiene un valore che indica se l'applicazione corrente è in esecuzione nella modalità pipeline integrata di IIS 7.0.

WebObjectActivator

Ottiene o imposta l'istanza IServiceProvider per supportare l'inserimento di dipendenze.

Metodi

Close()

Chiude l'istanza HttpRuntime.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetNamedPermissionSet()

Restituisce l'insieme di autorizzazioni associate ai gruppi di codice.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ProcessRequest(HttpWorkerRequest)

Guida l'esecuzione dell'elaborazione Web di ASP.NET.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
UnloadAppDomain()

Termina l'applicazione corrente. L'applicazione viene riavviata la volta successiva che viene ricevuta una richiesta per l'applicazione stessa.

Si applica a

Vedi anche