Freigeben über


HttpRuntime Klasse

Definition

Stellt einen Satz von ASP.NET-Laufzeitdiensten für die aktuelle Anwendung bereit.

public ref class HttpRuntime sealed
public sealed class HttpRuntime
type HttpRuntime = class
Public NotInheritable Class HttpRuntime
Vererbung
HttpRuntime

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Eigenschaften der Klasse abgerufen werden, die die HttpRuntime aktuelle Anwendungsdomäne darstellt und sie dem Browser anzeigt.

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

Hinweise

Das HttpRuntime Objekt wird am Anfang des ASP.NET Pipelinemodells verwendet, das HTTP-Anforderungen verarbeitet. Die ProcessRequest Methode steuert alle nachfolgenden ASP.NET Webverarbeitung.

Seitenentwickler können die HttpRuntime Klasseneigenschaften verwenden, um Informationen zu der aktuellen Anwendungsdomäne für Diagnosezwecke zu finden, z. B. Entwickler, die benutzerdefinierte Prozesspipeline oder eine benutzerdefinierte Hostingumgebung erstellen, sollten die Methode aus einer klasse aufrufen, die ProcessRequest von der oder der HttpWorkerRequest SimpleWorkerRequest Klasse abgeleitet wurde.

Konstruktoren

HttpRuntime()

Initialisiert eine neue Instanz der HttpRuntime-Klasse.

Eigenschaften

AppDomainAppId

Ruft die Anwendungsidentifikation der Anwendungsdomäne ab, in der sich die HttpRuntime befindet.

AppDomainAppPath

Ruft den physischen Laufwerkspfad des Anwendungsverzeichnisses für die in der aktuellen Anwendungsdomäne gehostete Anwendung ab.

AppDomainAppVirtualPath

Ruft den virtuellen Pfad des Verzeichnisses ab, das die in der aktuellen Anwendungsdomäne gehostete Anwendung enthält.

AppDomainId

Ruft die Domänenidentifikation der Anwendungsdomäne ab, in der sich die HttpRuntime-Instanz befindet.

AspClientScriptPhysicalPath

Ruft den Ordnerpfad für die ASP.NET-Clientskriptdateien ab.

AspClientScriptVirtualPath

Ruft den virtuellen Pfad für die ASP.NET-Clientskriptdateien ab.

AspInstallDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem die ausführbaren ASP.NET-Dateien installiert sind.

BinDirectory

Ruft den physischen Pfad des Verzeichnisses /bin für die aktuelle Anwendung ab.

Cache

Ruft den Cache für die aktuelle Anwendung ab.

ClrInstallDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem die ausführbaren Dateien der Common Language Runtime installiert sind.

CodegenDir

Ruft den physischen Pfad des Verzeichnisses ab, in dem ASP.NET temporäre Dateien (generierte Quellen, kompilierte Assemblys usw.) für die aktuelle Anwendung speichert.

IISVersion

Ruft die Version des IIS ab, welche diese Anwendung hostet.

IsOnUNCShare

Ruft einen Wert ab, der angibt, ob die Anwendung einer UNC-Freigabe (Universal Naming Convention) zugeordnet ist.

MachineConfigurationDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem sich die Datei Machine.config für die aktuelle Anwendung befindet.

TargetFramework

Ruft die Version von .NET Framework ab, die von der aktuellen Webanwendung als Ziel verwendet wird, oder legt sie fest.

UsingIntegratedPipeline

Ruft einen Wert ab, der angibt, ob die aktuelle Anwendung im integrierten Pipelinemodus von IIS 7.0 ausgeführt wird.

WebObjectActivator

Ruft die IServiceProvider-Instanz zur Unterstützung der Einfügung von Abhängigkeiten ab oder legt sie fest.

Methoden

Close()

Fährt die HttpRuntime-Instanz herunter.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetNamedPermissionSet()

Gibt den Berechtigungssatz zurück, der mit Codegruppen verknüpft ist.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ProcessRequest(HttpWorkerRequest)

Steuert die Ausführung der gesamten ASP.NET-Webverarbeitung.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
UnloadAppDomain()

Beendet die aktuelle Anwendung. Die Anwendung wird neu gestartet, wenn die nächste Anforderung für sie empfangen wird.

Gilt für

Siehe auch