HostingEnvironment Klasse

Referenz

Definition

Namespace:: System.Web.Hosting

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 für eine verwaltete Anwendung innerhalb ihrer Anwendungsdomäne Funktionen zur Anwendungsverwaltung und Anwendungsdienste bereit. Diese Klasse kann nicht vererbt werden.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Vererbung: Object

MarshalByRefObject
HostingEnvironment

Beispiele

Im folgenden Codebeispiel handelt es sich um eine Webseite, auf der die Anwendungsinformationen angezeigt werden, die aus dem HostingEnvironment Objekt verfügbar sind.

<%@ Page Language="C#" %>

<%@ Import Namespace="System.Web.Hosting" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Load(object sender, EventArgs e)
  {
    appID.Text = HostingEnvironment.ApplicationID;
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath;
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath;
    siteName.Text = HostingEnvironment.SiteName;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Hosting" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    appID.Text = HostingEnvironment.ApplicationID
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath
    siteName.Text = HostingEnvironment.SiteName
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

Hinweise

Jede verwaltete Anwendungsdomäne enthält eine statische Instanz der HostingEnvironment Klasse, die Zugriff auf Anwendungsverwaltungsfunktionen und Anwendungsdienste bietet.

Konstruktoren

HostingEnvironment()

Initialisiert eine neue Instanz der HostingEnvironment-Klasse.

Eigenschaften

ApplicationHost	Diese Eigenschaft unterstützt die ASP.NET-Infrastruktur und soll nicht direkt aus Ihrem Code verwendet werden.
ApplicationID	Ruft den eindeutigen Bezeichner der Anwendung ab.
ApplicationMonitors	Ruft eine Gruppe von ersetzbaren Monitorobjekten ab, die von ASP.NET-Subsystemen für die Verwaltung der Anwendungsintegrität verwendet werden.
ApplicationPhysicalPath	Ruft den physischen Pfad auf dem Datenträger zum Verzeichnis der Anwendung ab.
ApplicationVirtualPath	Ruft den virtuellen Stammpfad der Anwendung ab.
Cache	Ruft die Cache-Instanz für die aktuelle Anwendung ab.
InClientBuildManager	Ruft einen Wert ab, der angibt, ob die Hostumgebung auf das ASP.NET-Buildsystem zugreifen kann.
InitializationException	Ruft jede während der Initialisierung des HostingEnvironment-Objekts ausgelöste Ausnahme ab.
IsDevelopmentEnvironment	Ruft einen Wert ab, der angibt, ob sich die aktuelle Anwendung in einer Entwicklungsumgebung befindet.
IsHosted	Ruft einen Wert ab, der angibt, ob die aktuelle Anwendungsdomäne von einem ApplicationManager-Objekt gehostet wird.
MaxConcurrentRequestsPerCPU	Ruft die maximalen gleichzeitigen Anforderungen pro CPU ab oder legt sie fest.
MaxConcurrentThreadsPerCPU	Ruft die maximalen gleichzeitigen Threads pro CPU ab oder legt sie fest.
ShutdownReason	Gibt einen Enumerationswert zurück, der angibt, warum die Anwendung beendet wurde.
SiteName	Gibt den Namen des Standorts zurück.
VirtualPathProvider	Ruft den Anbieter des virtuellen Pfads für diese Anwendung ab.

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
DecrementBusyCount()	Verringert die Anzahl ausgelasteter Objekte in der gehosteten Umgebung um 1.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Impersonate()	Nimmt die Identität des durch die Anwendungsidentität dargestellten Benutzers an.
Impersonate(IntPtr)	Nimmt die Identität des durch das angegebene Benutzertoken dargestellten Benutzers an.
Impersonate(IntPtr, String)	Nimmt die Identität des Benutzers an, der in den Konfigurationseinstellungen für den angegebenen virtuellen Pfad oder das angegebene Benutzertoken angegeben ist.
IncrementBusyCount()	Erhöht die Anzahl ausgelasteter Objekte in der gehosteten Umgebung um 1.
InitializeLifetimeService()	Führt zu einer unendlichen Lebensdauer des HostingEnvironment-Objekts, indem das Erstellen eines Lease verhindert wird.
InitiateShutdown()	Beginnt mit dem Herunterfahren der diesem Host zugeordneten Webanwendung und entfernt registrierte Objekte aus dem System.
MapPath(String)	Ordnet einem physischen Pfad auf dem Server einen virtuellen Pfad zu.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MessageReceived()	Diese Methode unterstützt die ASP.NET-Infrastruktur und soll nicht direkt aus Ihrem Code verwendet werden.
QueueBackgroundWorkItem(Action<CancellationToken>)	Plant eine Aufgabe, die im Hintergrund und unabhängig von allen Anforderungen ausgeführt werden kann.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Plant eine Aufgabe, die im Hintergrund und unabhängig von allen Anforderungen ausgeführt werden kann.
RegisterObject(IRegisteredObject)	Fügt in die Liste von registrierten Objekten für die Anwendung ein Objekt ein.
RegisterVirtualPathProvider(VirtualPathProvider)	Registriert eine neue VirtualPathProvider-Instanz im ASP.NET-Kompilierungssystem.
SetCultures()	Legt den aktuellen Thread auf die in der Anwendungskonfigurationsdatei angegebene Kultur fest.
SetCultures(String)	Legt den aktuellen Thread auf die Kultur des angegebenen virtuellen Pfads fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UnregisterObject(IRegisteredObject)	Entfernt ein Objekt aus der Liste von registrierten Objekten für die Anwendung.

Ereignisse

StopListening

[Wird nur in .NET Framework 4.5.1 unterstützt]

Tritt auf, wenn der Arbeitsprozess oder diesem Host zugeordnete Anwendungspool nicht mehr auf neue Anforderungen lauscht und schließlich beendet wird.

Gilt für