HttpRuntime Klasse
Definition
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 eine Reihe 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 HttpRuntime Klasse abgerufen werden, die die aktuelle Anwendungsdomäne darstellt und im Browser angezeigt wird.
<%@ 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 z. B. Informationen zur aktuellen Anwendungsdomäne zu Diagnosezwecken zu finden. Entwickler, die eine benutzerdefinierte Prozesspipeline oder eine benutzerdefinierte Hostingumgebung erstellen, sollten die ProcessRequest Methode von einer von der oder HttpWorkerRequest der SimpleWorkerRequest Klasse abgeleiteten Klasse aufrufen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| HttpRuntime() |
Initialisiert eine neue Instanz der HttpRuntime-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AppDomainAppId |
Ruft die Anwendungsidentifikation der Anwendungsdomäne ab, in der die HttpRuntime Domäne vorhanden ist. |
| AppDomainAppPath |
Ruft den physischen Laufwerkpfad des Anwendungsverzeichnisses für die Anwendung ab, die in der aktuellen Anwendungsdomäne gehostet wird. |
| 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 die HttpRuntime Instanz vorhanden ist. |
| 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 ASP.NET ausführbaren Dateien installiert sind. |
| BinDirectory |
Ruft den physischen Pfad zum Verzeichnis "/bin" für die aktuelle Anwendung ab. |
| Cache |
Ruft die Cache für die aktuelle Anwendung ab. |
| ClrInstallDirectory |
Ruft den physischen Pfad zum Verzeichnis ab, in dem die ausführbaren Dateien der Common Language Runtime installiert sind. |
| CodegenDir |
Ruft den physischen Pfad zum Verzeichnis ab, in dem ASP.NET temporäre Dateien (generierte Quellen, kompilierte Assemblys usw.) für die aktuelle Anwendung speichert. |
| IISVersion |
Ruft die Version von IIS ab, die diese Anwendung hosten. |
| IsOnUNCShare |
Ruft einen Wert ab, der angibt, ob die Anwendung einer universellen Benennungskonvention (UNC)-Freigabe zugeordnet ist. |
| MachineConfigurationDirectory |
Ruft den physischen Pfad zum Verzeichnis ab, in dem sich die Machine.config Datei für die aktuelle Anwendung befindet. |
| TargetFramework |
Ruft die Version des .NET Frameworks ab, auf das die aktuelle Webanwendung ausgerichtet ist. |
| UsingIntegratedPipeline |
Ruft einen Wert ab, der angibt, ob die aktuelle Anwendung im integrierten Pipelinemodus von IIS 7.0 ausgeführt wird. |
| WebObjectActivator |
Ruft die Instanz für die IServiceProvider Unterstützung der Abhängigkeitseinfügung ab oder legt sie fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Beendet die HttpRuntime Instanz. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetNamedPermissionSet() |
Gibt den Satz von Berechtigungen zurück, die Codegruppen zugeordnet sind. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ProcessRequest(HttpWorkerRequest) |
Steuert alle ASP.NET Webverarbeitungsausführung. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| UnloadAppDomain() |
Beendet die aktuelle Anwendung. Die Anwendung startet neu, wenn eine Anforderung das nächste Mal empfangen wird. |