HostingEnvironment Classe

Definizione

Spazio dei nomi:
System.Web.Hosting
Assembly:
System.Web.dll

Fornisce funzioni di gestione delle applicazioni e servizi dell'applicazione a un'applicazione gestita all'interno del dominio dell'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 nell'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

Nome Descrizione
HostingEnvironment()

Inizializza una nuova istanza della classe HostingEnvironment.

Proprietà

Nome Descrizione
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 utilizzati dai sottosistemi ASP.NET per mantenere l'integrità dell'applicazione.
ApplicationPhysicalPath

Ottiene il percorso fisico su disco nella directory dell'applicazione.
ApplicationVirtualPath

Ottiene il percorso virtuale radice dell'applicazione.
Cache

Ottiene l'istanza Cache dell'applicazione corrente.
InClientBuildManager

Ottiene un valore che indica se l'ambiente host ha accesso al sistema di compilazione ASP.NET.
InitializationException

Ottiene qualsiasi eccezione generata durante l'inizializzazione dell'oggetto HostingEnvironment .
IsDevelopmentEnvironment

Ottiene un valore che indica se l'applicazione corrente si trova in un ambiente di sviluppo.
IsHosted

Ottiene un valore che indica se il dominio applicazione corrente è ospitato da un ApplicationManager oggetto .
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 il motivo per cui l'applicazione è stata terminata.
SiteName

Ottiene il nome del sito.
VirtualPathProvider

Ottiene il provider di percorsi virtuali per questa applicazione.

Metodi

Nome Descrizione
CreateObjRef(Type)

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.

(Ereditato da MarshalByRefObject)
DecrementBusyCount()

Riduce il numero di oggetti occupati nell'ambiente ospitato di uno.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
Impersonate()

Rappresenta l'utente rappresentato dall'identità dell'applicazione.
Impersonate(IntPtr, String)

Rappresenta l'utente specificato dalle impostazioni di configurazione per il percorso virtuale specificato o il token utente specificato.
Impersonate(IntPtr)

Rappresenta l'utente rappresentato dal token utente specificato.
IncrementBusyCount()

Aumenta il numero di oggetti occupati nell'ambiente ospitato di uno.
InitializeLifetimeService()

Assegna all'oggetto HostingEnvironment una durata infinita impedendo la creazione di un lease.
InitiateShutdown()

Avvia l'arresto 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 nel server.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject .

(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, indipendentemente da qualsiasi richiesta.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Pianifica un'attività che può essere eseguita in background, indipendentemente da qualsiasi richiesta.
RegisterObject(IRegisteredObject)

Inserisce un oggetto nell'elenco di oggetti registrati per l'applicazione.
RegisterVirtualPathProvider(VirtualPathProvider)

Registra una nuova istanza di 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 di oggetti registrati per l'applicazione.

Eventi

Nome Descrizione
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 alla fine si arresterà.

Si applica a