HttpRuntime Klasse

Definition

Stellt einen Satz von ASP.NET-Laufzeitdiensten für die aktuelle Anwendung bereit.Provides a set of ASP.NET run-time services for the current application.

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 HttpRuntime -Klasse, die die aktuelle Anwendungsdomäne darstellt, angezeigt und im Browser angezeigt werden.The following example demonstrates how to get properties of the HttpRuntime class representing the current application domain and display them to the 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>

Hinweise

Das HttpRuntime -Objekt wird am Anfang des ASP.NET-Pipeline Modells verwendet, das HTTP-Anforderungen verarbeitet.The HttpRuntime object is used at the beginning of the ASP.NET pipeline model that processes HTTP requests. Die ProcessRequest -Methode steuert alle nachfolgenden ASP.net-webverarbeitungs Vorgänge.The ProcessRequest method drives all subsequent ASP.NET Web processing.

Seiten Entwickler können die HttpRuntime Klasseneigenschaften verwenden, um Informationen über die aktuelle Anwendungsdomäne zu Diagnose Zwecken zu ermitteln, z. b.Page developers can use the HttpRuntime class properties to find out information about the current application domain for diagnostic purposes, for example. Entwickler, die eine benutzerdefinierte Prozess Pipeline oder eine benutzerdefinierte Hostingumgebung erstellen, sollten die ProcessRequest -Methode aus einer Klasse, die von der-Klasse oder der HttpWorkerRequest SimpleWorkerRequestDevelopers creating custom process pipeline or a custom hosting environment should call the ProcessRequest method from a class derived from the HttpWorkerRequest or SimpleWorkerRequest class.

Konstruktoren

HttpRuntime()

Initialisiert eine neue Instanz der HttpRuntime-Klasse.Initializes a new instance of the HttpRuntime class.

Eigenschaften

AppDomainAppId

Ruft die Anwendungsidentifikation der Anwendungsdomäne ab, in der sich die HttpRuntime befindet.Gets the application identification of the application domain where the HttpRuntime exists.

AppDomainAppPath

Ruft den physischen Laufwerkspfad des Anwendungsverzeichnisses für die in der aktuellen Anwendungsdomäne gehostete Anwendung ab.Gets the physical drive path of the application directory for the application hosted in the current application domain.

AppDomainAppVirtualPath

Ruft den virtuellen Pfad des Verzeichnisses ab, das die in der aktuellen Anwendungsdomäne gehostete Anwendung enthält.Gets the virtual path of the directory that contains the application hosted in the current application domain.

AppDomainId

Ruft die Domänenidentifikation der Anwendungsdomäne ab, in der sich die HttpRuntime-Instanz befindet.Gets the domain identification of the application domain where the HttpRuntime instance exists.

AspClientScriptPhysicalPath

Ruft den Ordnerpfad für die ASP.NET-Clientskriptdateien ab.Gets the folder path for the ASP.NET client script files.

AspClientScriptVirtualPath

Ruft den virtuellen Pfad für die ASP.NET-Clientskriptdateien ab.Gets the virtual path for the ASP.NET client script files.

AspInstallDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem die ausführbaren ASP.NET-Dateien installiert sind.Gets the physical path of the directory where the ASP.NET executable files are installed.

BinDirectory

Ruft den physischen Pfad des Verzeichnisses /bin für die aktuelle Anwendung ab.Gets the physical path to the /bin directory for the current application.

Cache

Ruft den Cache für die aktuelle Anwendung ab.Gets the Cache for the current application.

ClrInstallDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem die ausführbaren Dateien der Common Language Runtime installiert sind.Gets the physical path to the directory where the common language runtime executable files are installed.

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.Gets the physical path to the directory where ASP.NET stores temporary files (generated sources, compiled assemblies, and so on) for the current application.

IISVersion

Ruft die Version des IIS ab, welche diese Anwendung hostet.Gets the version of IIS that is hosting this application.

IsOnUNCShare

Ruft einen Wert ab, der angibt, ob die Anwendung einer UNC-Freigabe (Universal Naming Convention) zugeordnet ist.Gets a value that indicates whether the application is mapped to a universal naming convention (UNC) share.

MachineConfigurationDirectory

Ruft den physischen Pfad des Verzeichnisses ab, in dem sich die Datei Machine.config für die aktuelle Anwendung befindet.Gets the physical path to the directory where the Machine.config file for the current application is located.

TargetFramework

Ruft die Version von .NET Framework ab, die von der aktuellen Webanwendung als Ziel verwendet wird, oder legt sie fest.Gets the version of the .NET Framework that the current web application targets.

UsingIntegratedPipeline

Ruft einen Wert ab, der angibt, ob die aktuelle Anwendung im integrierten Pipelinemodus von IIS 7.0IIS 7.0 ausgeführt wird.Gets a value that indicates whether the current application is running in the integrated-pipeline mode of IIS 7.0IIS 7.0.

WebObjectActivator

Ruft die IServiceProvider-Instanz zur Unterstützung der Einfügung von Abhängigkeiten ab oder legt sie fest.Gets or sets the IServiceProvider instance for dependency injection support.

Methoden

Close()

Fährt die HttpRuntime-Instanz herunter.Shuts down the HttpRuntime instance.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetNamedPermissionSet()

Gibt den Berechtigungssatz zurück, der mit Codegruppen verknüpft ist.Returns the set of permissions associated with code groups.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ProcessRequest(HttpWorkerRequest)

Steuert die Ausführung der gesamten ASP.NET-Webverarbeitung.Drives all ASP.NET Web processing execution.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
UnloadAppDomain()

Beendet die aktuelle Anwendung.Terminates the current application. Die Anwendung wird neu gestartet, wenn die nächste Anforderung für sie empfangen wird.The application restarts the next time a request is received for it.

Gilt für:

Siehe auch