HostingEnvironment HostingEnvironment HostingEnvironment HostingEnvironment Class

Definition

Fournit des fonctions de gestion des applications et des services d'application à une application managée dans son domaine d'application. Provides application-management functions and application services to a managed application within its application domain. Cette classe ne peut pas être héritée. 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
Inheritance
HostingEnvironmentHostingEnvironmentHostingEnvironmentHostingEnvironment

Examples

L’exemple de code suivant est une page Web qui affiche les informations d’application disponibles à partir de la HostingEnvironment objet.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>

Remarks

Chaque domaine d’application managé contient une instance statique de la HostingEnvironment classe, qui fournit l’accès aux fonctions de gestion des applications et services d’application.Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

Constructors

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

Initialise une nouvelle instance de la classe HostingEnvironment. Initializes a new instance of the HostingEnvironment class.

Properties

ApplicationHost ApplicationHost ApplicationHost ApplicationHost

Cette propriété prend en charge l'infrastructure ASP.NETASP.NET et n'est pas destinée à être directement utilisée à partir de votre code. This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID ApplicationID ApplicationID ApplicationID

Obtient l'identificateur unique de l'application. Gets the unique identifier of the application.

ApplicationMonitors ApplicationMonitors ApplicationMonitors ApplicationMonitors

Obtient un groupe d’objets d’analyse remplaçables utilisés par les sous-systèmes ASP.NET pour maintenir l’intégrité de l’application. Gets a group of repleacable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath

Obtient le chemin d’accès physique sur disque au répertoire de l’application. Gets the physical path on disk to the application's directory.

ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath

Obtient le chemin d’accès virtuel racine de l’application. Gets the root virtual path of the application.

Cache Cache Cache Cache

Obtient l'instance de Cache pour l'application actuelle. Gets the Cache instance for the current application.

InClientBuildManager InClientBuildManager InClientBuildManager InClientBuildManager

Obtient une valeur qui indique si l'environnement d'hébergement a accès au système de génération ASP.NET. Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException InitializationException InitializationException InitializationException

Obtient toute exception levée pendant l'initialisation de l'objet HostingEnvironment. Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment

Obtient une valeur qui indique si l'application active est dans un environnement de développement. Gets a value that indicats whether the current application is in a development environment.

IsHosted IsHosted IsHosted IsHosted

Obtient une valeur indiquant si le domaine d'application actuel est hébergé par un objet ApplicationManager. Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU

Obtient ou définit le nombre maximal de requêtes simultanées par UC. Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU

Obtient ou définit le nombre maximal de threads simultanés par UC. Gets or sets the maximum concurrent threads per CPU.

ShutdownReason ShutdownReason ShutdownReason ShutdownReason

Retourne une valeur énumérée qui indique pourquoi l'application a été fermée. Returns an enumerated value that indicates why the application terminated.

SiteName SiteName SiteName SiteName

Obtient le nom du site. Gets the name of the site.

VirtualPathProvider VirtualPathProvider VirtualPathProvider VirtualPathProvider

Obtient le fournisseur de chemins d’accès virtuels pour cette application. Gets the virtual path provider for this application.

Methods

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

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. 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()

Réduit d'un incrément le décompte des objets occupés dans l'environnement hébergé. Reduces the count of busy objects in the hosted environment by one.

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

Détermine si l'objet spécifié est identique à l'objet actuel. Determines whether the specified object is equal to the current object.

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

Fait office de fonction de hachage par défaut. Serves as the default hash function.

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

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Obtient le Type de l'instance actuelle. Gets the Type of the current instance.

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

Emprunte l'identité de l'utilisateur représenté par l'identité de l'application. Impersonates the user represented by the application identity.

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

Emprunte l'identité de l'utilisateur représenté par le jeton utilisateur spécifié. Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String)

Emprunte l’identité de l’utilisateur spécifié par les paramètres de configuration pour le chemin d’accès virtuel spécifié ou le jeton utilisateur spécifié. Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

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

Augmente d'un incrément le décompte des objets occupés dans l'environnement hébergé. Increases the count of busy objects in the hosted environment by one.

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

Donne à l'objet HostingEnvironment une durée de vie infinie en empêchant toute création de bail. Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

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

Démarre l'arrêt de l'application web associée à cet hôte et supprime les objets inscrits du système. 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)

Mappe un chemin d’accès virtuel à un chemin d’accès physique sur le serveur. Maps a virtual path to a physical path on the server.

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

Crée une copie superficielle du Object actuel. Creates a shallow copy of the current Object.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel. Creates a shallow copy of the current MarshalByRefObject object.

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

Cette méthode prend en charge l'infrastructure ASP.NETASP.NET et n'est pas destinée à être directement utilisée à partir de votre code. 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>)

[Pris en charge dans .NET Framework 4.5.2 et ultérieur] [Supported in the .NET Framework 4.5.2 and later versions] Planifie une tâche qui peut s’exécuter en arrière-plan, indépendamment de toute requête. 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>)

[Pris en charge dans .NET Framework 4.5.2 et ultérieur] [Supported in the .NET Framework 4.5.2 and later versions] Planifie une tâche qui peut s’exécuter en arrière-plan, indépendamment de toute requête. Schedules a task which can run in the background, independent of any request.

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

Place un objet dans la liste d'objets inscrits pour l'application. Places an object in the list of registered objects for the application.

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

Inscrit une nouvelle instance de VirtualPathProvider dans le système de compilation ASP.NET. Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

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

Affecte au thread actuel la culture spécifiée dans le fichier de configuration de l'application. Sets the current thread to the culture specified in the application configuration file.

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

Affecte au thread actuel la culture du chemin d’accès virtuel spécifié. Sets the current thread to the culture of the specified virtual path.

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

Retourne une chaîne qui représente l'objet actuel. Returns a string that represents the current object.

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

Supprime un objet de la liste d'objets inscrits pour l'application. Removes an object from the list of registered objects for the application.

Events

StopListening StopListening StopListening StopListening

[Pris en charge dans le .NET Framework 4.5.1 uniquement] [Supported in the .NET Framework 4.5.1 only] Se produit quand le processus de travail ou le pool d'applications associé à cet hôte a cessé d'écouter les nouvelles requêtes et finit par s'arrêter. Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

Applies to