HostingEnvironment Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Hosting

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce le funzioni di gestione dell'applicazione e i servizi delle applicazioni a un'applicazione gestita all'interno del relativo dominio applicazione. La classe non può essere ereditata.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Ereditarietà: Object

MarshalByRefObject
HostingEnvironment

Esempio

L'esempio di codice seguente è una pagina Web che visualizza le informazioni sull'applicazione disponibili dall'oggetto 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>

Commenti

Ogni dominio applicazione gestito contiene un'istanza statica della HostingEnvironment classe , che fornisce l'accesso alle funzioni di gestione delle applicazioni e ai servizi dell'applicazione.

Costruttori

HostingEnvironment()

Inizializza una nuova istanza della classe HostingEnvironment.

Proprietà

ApplicationHost	Questa proprietà supporta l'infrastruttura ASP.NET e non deve essere usata direttamente dal codice.
ApplicationID	Ottiene l'identificatore univoco dell'applicazione.
ApplicationMonitors	Ottiene un gruppo di oggetti di monitoraggio sostituibili usati dai sottosistemi ASP.NET per mantenere l'integrità dell'applicazione.
ApplicationPhysicalPath	Ottiene il percorso fisico su disco della directory dell'applicazione.
ApplicationVirtualPath	Ottiene il percorso virtuale della radice dell'applicazione.
Cache	Ottiene l'istanza di Cache per l'applicazione corrente.
InClientBuildManager	Ottiene un valore che indica se l'ambiente host dispone dell'accesso al sistema di compilazione ASP.NET.
InitializationException	Ottiene un'eccezione generata durante l'inizializzazione dell'oggetto HostingEnvironment.
IsDevelopmentEnvironment	Ottiene un valore che indica se l'applicazione corrente è in un ambiente di sviluppo.
IsHosted	Ottiene un valore che indica se il dominio applicazione corrente è contenuto in un oggetto ApplicationManager.
MaxConcurrentRequestsPerCPU	Ottiene o imposta il numero massimo di richieste simultanee per CPU.
MaxConcurrentThreadsPerCPU	Ottiene o imposta il numero massimo di thread simultanei per CPU.
ShutdownReason	Restituisce un valore enumerato che indica la ragione per cui l'applicazione è stata terminata.
SiteName	Ottiene il nome del sito.
VirtualPathProvider	Ottiene il provider del percorso virtuale per questa applicazione.

Metodi

CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
DecrementBusyCount()	Riduce di uno il numero di oggetti occupati nell'ambiente host.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleta. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Impersonate()	Rappresenta l'utente definito dall'identità dell'applicazione.
Impersonate(IntPtr)	Rappresenta l'utente definito dal token utente specificato.
Impersonate(IntPtr, String)	Rappresenta l'utente specificato dalle impostazioni della configurazione per il percorso virtuale specificato o il token utente specificato.
IncrementBusyCount()	Aumenta di uno il numero di oggetti occupati nell'ambiente host.
InitializeLifetimeService()	Fornisce all'oggetto HostingEnvironment una durata infinita impedendo la creazione di lease.
InitiateShutdown()	Avvia la chiusura dell'applicazione Web associata a questo host e rimuove gli oggetti registrati dal sistema.
MapPath(String)	Esegue il mapping di un percorso virtuale a un percorso fisico sul server.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
MessageReceived()	Questo metodo supporta l'infrastruttura ASP.NET e non deve essere usato direttamente dal codice.
QueueBackgroundWorkItem(Action<CancellationToken>)	Pianifica un'attività che può essere eseguita in background, indipendente da qualsiasi richiesta.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Pianifica un'attività che può essere eseguita in background, indipendente da qualsiasi richiesta.
RegisterObject(IRegisteredObject)	Inserisce un oggetto nell'elenco degli oggetti registrati per l'applicazione.
RegisterVirtualPathProvider(VirtualPathProvider)	Registra una nuova istanza VirtualPathProvider con il sistema di compilazione ASP.NET.
SetCultures()	Imposta il thread corrente sulle impostazioni cultura specificate nel file di configurazione dell'applicazione.
SetCultures(String)	Imposta il thread corrente sulle impostazioni cultura del percorso virtuale specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UnregisterObject(IRegisteredObject)	Rimuove un oggetto dall'elenco degli oggetti registrati per l'applicazione.

Eventi

StopListening

[Supportato solo in .NET Framework 4.5.1.]

Si verifica quando il processo di lavoro o il pool di applicazioni associato a questo host ha interrotto l'ascolto delle nuove richieste e viene infine arrestato.

Si applica a