Partager via


HostingEnvironment Classe

Définition

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
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 à