HostingEnvironment Classe

Definizione

Fornisce le funzioni di gestione dell'applicazione e i servizi applicativi a un'applicazione gestita all'interno del relativo dominio applicazione.Provides application-management functions and application services to a managed application within its application domain. Questa classe non può essere ereditata.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
Ereditarietà
HostingEnvironment

Esempi

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

Commenti

Ogni dominio applicazione gestita contiene un'istanza statica della HostingEnvironment classe, che fornisce l'accesso alle funzioni di gestione delle applicazioni e ai servizi dell'applicazione.Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

Costruttori

HostingEnvironment()

Inizializza una nuova istanza della classe HostingEnvironment.Initializes a new instance of the HostingEnvironment class.

Proprietà

ApplicationHost

Questa proprietà supporta l'infrastruttura di ASP.NETASP.NET e non deve essere usata direttamente dal codice.This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID

Ottiene l'identificatore univoco dell'applicazione.Gets the unique identifier of the application.

ApplicationMonitors

Ottiene un gruppo di oggetti di monitoraggio sostituibili usati dai sottosistemi ASP.NET per mantenere l'integrità dell'applicazione.Gets a group of replaceable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath

Ottiene il percorso fisico su disco della directory dell'applicazione.Gets the physical path on disk to the application's directory.

ApplicationVirtualPath

Ottiene il percorso virtuale della radice dell'applicazione.Gets the root virtual path of the application.

Cache

Ottiene l'istanza di Cache per l'applicazione corrente.Gets the Cache instance for the current application.

InClientBuildManager

Ottiene un valore che indica se l'ambiente host dispone dell'accesso al sistema di compilazione ASP.NET.Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException

Ottiene un'eccezione generata durante l'inizializzazione dell'oggetto HostingEnvironment.Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment

Ottiene un valore che indica se l'applicazione corrente è in un ambiente di sviluppo.Gets a value that indicates whether the current application is in a development environment.

IsHosted

Ottiene un valore che indica se il dominio applicazione corrente è contenuto in un oggetto ApplicationManager.Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU

Ottiene o imposta il numero massimo di richieste simultanee per CPU.Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU

Ottiene o imposta il numero massimo di thread simultanei per CPU.Gets or sets the maximum concurrent threads per CPU.

ShutdownReason

Restituisce un valore enumerato che indica la ragione per cui l'applicazione è stata terminata.Returns an enumerated value that indicates why the application terminated.

SiteName

Ottiene il nome del sito.Gets the name of the site.

VirtualPathProvider

Ottiene il provider del percorso virtuale per questa applicazione.Gets the virtual path provider for this application.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
DecrementBusyCount()

Riduce di uno il numero di oggetti occupati nell'ambiente host.Reduces the count of busy objects in the hosted environment by one.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Impersonate()

Rappresenta l'utente definito dall'identità dell'applicazione.Impersonates the user represented by the application identity.

Impersonate(IntPtr)

Rappresenta l'utente definito dal token utente specificato.Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String)

Rappresenta l'utente specificato dalle impostazioni della configurazione per il percorso virtuale specificato o il token utente specificato.Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

IncrementBusyCount()

Aumenta di uno il numero di oggetti occupati nell'ambiente host.Increases the count of busy objects in the hosted environment by one.

InitializeLifetimeService()

Fornisce all'oggetto HostingEnvironment una durata infinita impedendo la creazione di lease.Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

InitiateShutdown()

Avvia la chiusura dell'applicazione Web associata a questo host e rimuove gli oggetti registrati dal sistema.Starts shutting down the web application associated with this host and removes registered objects from the system.

MapPath(String)

Esegue il mapping di un percorso virtuale a un percorso fisico sul server.Maps a virtual path to a physical path on the server.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
MessageReceived()

Questo metodo supporta l'infrastruttura di ASP.NETASP.NET e non deve essere usato direttamente dal codice.This method supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

QueueBackgroundWorkItem(Action<CancellationToken>)

Pianifica un'attività che può essere eseguita in background, indipendente da qualsiasi richiesta.Schedules a task which can run in the background, independent of any request.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Pianifica un'attività che può essere eseguita in background, indipendente da qualsiasi richiesta.Schedules a task which can run in the background, independent of any request.

RegisterObject(IRegisteredObject)

Inserisce un oggetto nell'elenco degli oggetti registrati per l'applicazione.Places an object in the list of registered objects for the application.

RegisterVirtualPathProvider(VirtualPathProvider)

Registra una nuova istanza VirtualPathProvider con il sistema di compilazione ASP.NET.Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

SetCultures()

Imposta il thread corrente sulle impostazioni cultura specificate nel file di configurazione dell'applicazione.Sets the current thread to the culture specified in the application configuration file.

SetCultures(String)

Imposta il thread corrente sulle impostazioni cultura del percorso virtuale specificato.Sets the current thread to the culture of the specified virtual path.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
UnregisterObject(IRegisteredObject)

Rimuove un oggetto dall'elenco degli oggetti registrati per l'applicazione.Removes an object from the list of registered objects for the application.

Eventi

StopListening

[Supportato solo in .NET Framework 4.5.1.][Supported in the .NET Framework 4.5.1 only]

Si verifica quando il processo di lavoro o il pool di applicazioni associato a questo host ha interrotto l'ascolto delle nuove richieste e verrà infine arrestato.Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

Si applica a