HostingEnvironment Klasse

Definition

Namespace:
System.Web.Hosting
Assembly:
System.Web.dll

Stellt Anwendungsverwaltungsfunktionen und Anwendungsdienste für eine verwaltete Anwendung innerhalb ihrer Anwendungsdomäne 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

Das folgende Codebeispiel ist eine Webseite, auf der die vom Objekt verfügbaren Anwendungsinformationen angezeigt werden HostingEnvironment .

<%@ 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 ermöglicht.

Konstruktoren

Name Beschreibung
HostingEnvironment()

Initialisiert eine neue Instanz der HostingEnvironment-Klasse.

Eigenschaften

Name Beschreibung
ApplicationHost

Diese Eigenschaft unterstützt die ASP.NET-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ApplicationID

Ruft den eindeutigen Bezeichner der Anwendung ab.
ApplicationMonitors

Ruft eine Gruppe von austauschbaren Monitorobjekten ab, die von ASP.NET Subsystemen verwendet werden, um den Anwendungsstatus aufrechtzuerhalten.
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 Hostingumgebung Zugriff auf das ASP.NET Buildsystem hat.
InitializationException

Ruft eine Ausnahme ab, die während der Initialisierung des HostingEnvironment Objekts ausgelöst wird.
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 diese fest.
MaxConcurrentThreadsPerCPU

Ruft die maximalen gleichzeitigen Threads pro CPU ab oder legt sie fest.
ShutdownReason

Gibt einen Aufzählungswert zurück, der angibt, warum die Anwendung beendet wurde.
SiteName

Ruft den Namen der Website ab.
VirtualPathProvider

Ruft den virtuellen Pfadanbieter für diese Anwendung ab.

Methoden

Name Beschreibung
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
DecrementBusyCount()

Reduziert die Anzahl der ausgelasteten Objekte in der gehosteten Umgebung um eins.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Impersonate()

Imitiert den Benutzer, der durch die Anwendungsidentität dargestellt wird.
Impersonate(IntPtr, String)

Imitiert den Benutzer, der durch die Konfigurationseinstellungen für den angegebenen virtuellen Pfad oder das angegebene Benutzertoken angegeben wurde.
Impersonate(IntPtr)

Imitiert den Benutzer, der durch das angegebene Benutzertoken dargestellt wird.
IncrementBusyCount()

Erhöht die Anzahl der ausgelasteten Objekte in der gehosteten Umgebung um eins.
InitializeLifetimeService()

Gibt dem HostingEnvironment Objekt eine unendliche Lebensdauer, indem verhindert wird, dass eine Lease erstellt wird.
InitiateShutdown()

Startet das Herunterfahren der Webanwendung, die diesem Host zugeordnet ist, und entfernt registrierte Objekte aus dem System.
MapPath(String)

Ordnet einen virtuellen Pfad einem physischen Pfad auf dem Server zu.
MemberwiseClone()

Erstellt eine flache Kopie der 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 ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
QueueBackgroundWorkItem(Action<CancellationToken>)

Plant eine Aufgabe, die unabhängig von jeder Anforderung im Hintergrund ausgeführt werden kann.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Plant eine Aufgabe, die unabhängig von jeder Anforderung im Hintergrund ausgeführt werden kann.
RegisterObject(IRegisteredObject)

Platziert ein Objekt in der Liste der registrierten Objekte für die Anwendung.
RegisterVirtualPathProvider(VirtualPathProvider)

Registriert eine neue VirtualPathProvider-Instanz mit dem 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 der registrierten Objekte für die Anwendung.

Ereignisse

Name Beschreibung
StopListening

[Nur im .NET Framework 4.5.1 unterstützt]

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

Gilt für: