HostingEnvironment HostingEnvironment HostingEnvironment HostingEnvironment Class

Definition

Stellt für eine verwaltete Anwendung innerhalb ihrer Anwendungsdomäne Funktionen zur Anwendungsverwaltung und Anwendungsdienste bereit. Provides application-management functions and application services to a managed application within its application domain. Diese Klasse kann nicht vererbt werden. This class cannot be inherited.

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
Vererbung
HostingEnvironmentHostingEnvironmentHostingEnvironmentHostingEnvironment

Beispiele

Im folgenden Codebeispiel wird eine Webseite, die die Anwendungsinformationen verfügbar zeigt die HostingEnvironment Objekt.The following code example is a webpage that displays the application information available from the HostingEnvironment object.

<%@ 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 Domäne für die verwaltete Anwendung enthält eine statische Instanz der dem HostingEnvironment -Klasse, die Zugriff auf Funktionen zur anwendungsverwaltung und Anwendungsdienste bietet.Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

Konstruktoren

HostingEnvironment() HostingEnvironment() HostingEnvironment() HostingEnvironment()

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

Eigenschaften

ApplicationHost ApplicationHost ApplicationHost ApplicationHost

Diese Eigenschaft unterstützt die ASP.NETASP.NET-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen. This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID ApplicationID ApplicationID ApplicationID

Ruft den eindeutigen Bezeichner der Anwendung ab. Gets the unique identifier of the application.

ApplicationMonitors ApplicationMonitors ApplicationMonitors ApplicationMonitors

Ruft eine Gruppe von ersetzbaren Monitorobjekten ab, die von ASP.NET-Subsystemen für die Verwaltung der Anwendungsintegrität verwendet werden. Gets a group of repleacable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath

Ruft den physischen Pfad auf dem Datenträger zum Verzeichnis der Anwendung ab. Gets the physical path on disk to the application's directory.

ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath

Ruft den virtuellen Stammpfad der Anwendung ab. Gets the root virtual path of the application.

Cache Cache Cache Cache

Ruft die Cache-Instanz für die aktuelle Anwendung ab. Gets the Cache instance for the current application.

InClientBuildManager InClientBuildManager InClientBuildManager InClientBuildManager

Ruft einen Wert ab, der angibt, ob die Hostumgebung auf das ASP.NET-Buildsystem zugreifen kann. Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException InitializationException InitializationException InitializationException

Ruft jede während der Initialisierung des HostingEnvironment-Objekts ausgelöste Ausnahme ab. Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment

Ruft einen Wert ab, der angibt, ob sich die aktuelle Anwendung in einer Entwicklungsumgebung befindet. Gets a value that indicats whether the current application is in a development environment.

IsHosted IsHosted IsHosted IsHosted

Ruft einen Wert ab, der angibt, ob die aktuelle Anwendungsdomäne von einem ApplicationManager-Objekt gehostet wird. Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU

Ruft die maximalen gleichzeitigen Anforderungen pro CPU ab oder legt sie fest. Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU

Ruft die maximalen gleichzeitigen Threads pro CPU ab oder legt sie fest. Gets or sets the maximum concurrent threads per CPU.

ShutdownReason ShutdownReason ShutdownReason ShutdownReason

Gibt einen Enumerationswert zurück, der angibt, warum die Anwendung beendet wurde. Returns an enumerated value that indicates why the application terminated.

SiteName SiteName SiteName SiteName

Gibt den Namen des Standorts zurück. Gets the name of the site.

VirtualPathProvider VirtualPathProvider VirtualPathProvider VirtualPathProvider

Ruft den Anbieter des virtuellen Pfads für diese Anwendung ab. Gets the virtual path provider for this application.

Methoden

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DecrementBusyCount() DecrementBusyCount() DecrementBusyCount() DecrementBusyCount()

Verringert die Anzahl ausgelasteter Objekte in der gehosteten Umgebung um 1. Reduces the count of busy objects in the hosted environment by one.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Impersonate() Impersonate() Impersonate() Impersonate()

Nimmt die Identität des durch die Anwendungsidentität dargestellten Benutzers an. Impersonates the user represented by the application identity.

Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr)

Nimmt die Identität des durch das angegebene Benutzertoken dargestellten Benutzers an. Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String) 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. Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

IncrementBusyCount() IncrementBusyCount() IncrementBusyCount() IncrementBusyCount()

Erhöht die Anzahl ausgelasteter Objekte in der gehosteten Umgebung um 1. Increases the count of busy objects in the hosted environment by one.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Führt zu einer unendlichen Lebensdauer des HostingEnvironment-Objekts, indem das Erstellen eines Lease verhindert wird. Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

InitiateShutdown() InitiateShutdown() InitiateShutdown() InitiateShutdown()

Beginnt mit dem Herunterfahren der diesem Host zugeordneten Webanwendung und entfernt registrierte Objekte aus dem System. Starts shutting down the web application associated with this host and removes registered objects from the system.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

Ordnet einem physischen Pfad auf dem Server einen virtuellen Pfad zu. Maps a virtual path to a physical path on the server.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MessageReceived() MessageReceived() MessageReceived() MessageReceived()

Diese Methode unterstützt die ASP.NETASP.NET-Infrastruktur und ist nicht für die direkte Verwendung in Code vorgesehen. This method supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>)

[Wird nur in .NET Framework 4.5.2 und neueren Versionen unterstützt] [Supported in the .NET Framework 4.5.2 and later versions] Plant eine Aufgabe, die im Hintergrund und unabhängig von allen Anforderungen ausgeführt werden kann. Schedules a task which can run in the background, independent of any request.

QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>)

[Wird nur in .NET Framework 4.5.2 und neueren Versionen unterstützt] [Supported in the .NET Framework 4.5.2 and later versions] Plant eine Aufgabe, die im Hintergrund und unabhängig von allen Anforderungen ausgeführt werden kann. Schedules a task which can run in the background, independent of any request.

RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject)

Fügt in die Liste von registrierten Objekten für die Anwendung ein Objekt ein. Places an object in the list of registered objects for the application.

RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider)

Registriert eine neue VirtualPathProvider-Instanz im ASP.NET-Kompilierungssystem. Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

SetCultures() SetCultures() SetCultures() SetCultures()

Legt den aktuellen Thread auf die in der Anwendungskonfigurationsdatei angegebene Kultur fest. Sets the current thread to the culture specified in the application configuration file.

SetCultures(String) SetCultures(String) SetCultures(String) SetCultures(String)

Legt den aktuellen Thread auf die Kultur des angegebenen virtuellen Pfads fest. Sets the current thread to the culture of the specified virtual path.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)
UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject)

Entfernt ein Objekt aus der Liste von registrierten Objekten für die Anwendung. Removes an object from the list of registered objects for the application.

Ereignisse

StopListening StopListening StopListening StopListening

[Wird nur in .NET Framework 4.5.1 unterstützt] [Supported in the .NET Framework 4.5.1 only] Tritt auf, wenn der Arbeitsprozess oder diesem Host zugeordnete Anwendungspool nicht mehr auf neue Anforderungen lauscht und schließlich beendet wird. Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

Gilt für: