HostingEnvironment Classe

Référence

Définition

Espace de noms:: System.Web.Hosting

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des fonctions de gestion des applications et des services d'application à une application managée dans son domaine d'application. Cette classe ne peut pas être héritée.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Héritage: Object

MarshalByRefObject
HostingEnvironment

Exemples

L’exemple de code suivant est une page web qui affiche les informations de l’application disponibles à partir de l’objet 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>

Remarques

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 aux services d’application.

Constructeurs

HostingEnvironment()

Initialise une nouvelle instance de la classe HostingEnvironment.

Propriétés

ApplicationHost	Cette propriété prend en charge l’infrastructure ASP.NET et n’est pas destinée à être utilisée directement à partir de votre code.
ApplicationID	Obtient l'identificateur unique de l'application.
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.
ApplicationPhysicalPath	Obtient le chemin d’accès physique sur disque au répertoire de l’application.
ApplicationVirtualPath	Obtient le chemin d’accès virtuel racine de l’application.
Cache	Obtient l'instance de Cache pour l'application actuelle.
InClientBuildManager	Obtient une valeur qui indique si l'environnement d'hébergement a accès au système de génération ASP.NET.
InitializationException	Obtient toute exception levée pendant l'initialisation de l'objet HostingEnvironment.
IsDevelopmentEnvironment	Obtient une valeur indiquant si l’application active est dans un environnement de développement.
IsHosted	Obtient une valeur indiquant si le domaine d'application actuel est hébergé par un objet ApplicationManager.
MaxConcurrentRequestsPerCPU	Obtient ou définit le nombre maximal de requêtes simultanées par UC.
MaxConcurrentThreadsPerCPU	Obtient ou définit le nombre maximal de threads simultanés par UC.
ShutdownReason	Retourne une valeur énumérée qui indique pourquoi l'application a été fermée.
SiteName	Obtient le nom du site.
VirtualPathProvider	Obtient le fournisseur de chemins d'accès virtuels pour cette application.

Méthodes

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. (Hérité de MarshalByRefObject)
DecrementBusyCount()	Réduit d'un incrément le décompte des objets occupés dans l'environnement hébergé.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. 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. (Hérité de MarshalByRefObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Impersonate()	Emprunte l'identité de l'utilisateur représenté par l'identité de l'application.
Impersonate(IntPtr)	Emprunte l'identité de l'utilisateur représenté par le jeton utilisateur spécifié.
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é.
IncrementBusyCount()	Augmente d'un incrément le décompte des objets occupés dans l'environnement hébergé.
InitializeLifetimeService()	Donne à l'objet HostingEnvironment une durée de vie infinie en empêchant toute création de bail.
InitiateShutdown()	Démarre l'arrêt de l'application web associée à cet hôte et supprime les objets inscrits du système.
MapPath(String)	Mappe un chemin d'accès virtuel à un chemin d'accès physique sur le serveur.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MessageReceived()	Cette méthode prend en charge l’infrastructure ASP.NET et n’est pas destinée à être utilisée directement à partir de votre code.
QueueBackgroundWorkItem(Action<CancellationToken>)	Planifie une tâche qui peut s’exécuter en arrière-plan, indépendamment de toute requête.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Planifie une tâche qui peut s’exécuter en arrière-plan, indépendamment de toute requête.
RegisterObject(IRegisteredObject)	Place un objet dans la liste d'objets inscrits pour l'application.
RegisterVirtualPathProvider(VirtualPathProvider)	Inscrit une nouvelle instance de VirtualPathProvider dans le système de compilation ASP.NET.
SetCultures()	Affecte au thread actuel la culture spécifiée dans le fichier de configuration de l'application.
SetCultures(String)	Affecte au thread actuel la culture du chemin d’accès virtuel spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UnregisterObject(IRegisteredObject)	Supprime un objet de la liste d'objets inscrits pour l'application.

Événements

StopListening

[Pris en charge dans le .NET Framework 4.5.1 uniquement]

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.

S’applique à