HttpRuntime Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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