HostingEnvironment HostingEnvironment HostingEnvironment HostingEnvironment Class

Definición

Proporciona funciones de administración de aplicaciones y servicios de aplicación a aplicaciones administradas en sus dominios de aplicación.Provides application-management functions and application services to a managed application within its application domain. Esta clase no puede heredarse.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
Herencia
HostingEnvironmentHostingEnvironmentHostingEnvironmentHostingEnvironment

Ejemplos

El siguiente ejemplo de código es una página web que muestra la información de la HostingEnvironment aplicación disponible en el objeto.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>

Comentarios

Cada dominio de aplicación administrado contiene una instancia estática de HostingEnvironment la clase, que proporciona acceso a las funciones de administración de aplicaciones y a los servicios de aplicación.Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

Constructores

HostingEnvironment() HostingEnvironment() HostingEnvironment() HostingEnvironment()

Inicializa una nueva instancia de la clase HostingEnvironment.Initializes a new instance of the HostingEnvironment class.

Propiedades

ApplicationHost ApplicationHost ApplicationHost ApplicationHost

Esta propiedad es compatible con la infraestructura de ASP.NETASP.NET y no está diseñada para utilizarse directamente desde el código.This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID ApplicationID ApplicationID ApplicationID

Obtiene el identificador único de la aplicación.Gets the unique identifier of the application.

ApplicationMonitors ApplicationMonitors ApplicationMonitors ApplicationMonitors

Obtiene un grupo de objetos de supervisión reemplazables que usan los subsistemas ASP.NET para mantener el estado de la aplicación.Gets a group of replaceable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath

Obtiene la ruta de acceso física en disco al directorio de la aplicación.Gets the physical path on disk to the application's directory.

ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath

Obtiene la ruta de acceso virtual raíz de la aplicación.Gets the root virtual path of the application.

Cache Cache Cache Cache

Obtiene la instancia de Cache para la aplicación actual.Gets the Cache instance for the current application.

InClientBuildManager InClientBuildManager InClientBuildManager InClientBuildManager

Obtiene un valor que indica si el entorno de hospedaje tiene acceso al sistema de compilación de ASP.NET.Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException InitializationException InitializationException InitializationException

Obtiene las excepciones producidas durante la inicialización del objeto HostingEnvironment.Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment

Obtiene un valor que indica si la aplicación actual está en un entorno de desarrollo.Gets a value that indicates whether the current application is in a development environment.

IsHosted IsHosted IsHosted IsHosted

Obtiene un valor que indica si un objeto ApplicationManager hospeda el dominio de aplicación actual.Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU

Obtiene o establece el número máximo de solicitudes simultáneas por CPU.Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU

Obtiene o establece el número máximo de subprocesos simultáneos por CPU.Gets or sets the maximum concurrent threads per CPU.

ShutdownReason ShutdownReason ShutdownReason ShutdownReason

Devuelve un valor enumerado que indica por qué ha finalizado la aplicación.Returns an enumerated value that indicates why the application terminated.

SiteName SiteName SiteName SiteName

Obtiene el nombre del sitio.Gets the name of the site.

VirtualPathProvider VirtualPathProvider VirtualPathProvider VirtualPathProvider

Obtiene el proveedor de la ruta de acceso virtual de esta aplicación.Gets the virtual path provider for this application.

Métodos

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DecrementBusyCount() DecrementBusyCount() DecrementBusyCount() DecrementBusyCount()

Reduce en uno el número de objetos ocupados en el entorno hospedado.Reduces the count of busy objects in the hosted environment by one.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Impersonate() Impersonate() Impersonate() Impersonate()

Suplanta al usuario representado por la identidad de aplicaciones.Impersonates the user represented by the application identity.

Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr)

Suplanta al usuario representado por el token de usuario especificado.Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String)

Suplanta al usuario especificado por los valores de configuración de la ruta de acceso virtual especificada o el token de usuario especificado.Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

IncrementBusyCount() IncrementBusyCount() IncrementBusyCount() IncrementBusyCount()

Aumenta en uno el número de objetos ocupados en el entorno hospedado.Increases the count of busy objects in the hosted environment by one.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Concede al objeto HostingEnvironment una duración infinita ya que impide que se genere una concesión.Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

InitiateShutdown() InitiateShutdown() InitiateShutdown() InitiateShutdown()

Inicia el cierre de la aplicación web asociada a este host y quita los objetos registrados del sistema.Starts shutting down the web application associated with this host and removes registered objects from the system.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

Asigna una ruta de acceso virtual a una ruta de acceso física en el servidor.Maps a virtual path to a physical path on the server.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MessageReceived() MessageReceived() MessageReceived() MessageReceived()

Este método es compatible con la infraestructura de ASP.NETASP.NET y no está diseñado para utilizarse directamente desde el código.This method supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>)

Programa una tarea que se puede ejecutar en segundo plano, independientemente de cualquier solicitud.Schedules a task which can run in the background, independent of any request.

QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Programa una tarea que se puede ejecutar en segundo plano, independientemente de cualquier solicitud.Schedules a task which can run in the background, independent of any request.

RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject)

Coloca un objeto en la lista de objetos registrados de la aplicación.Places an object in the list of registered objects for the application.

RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider)

Registra una nueva instancia de VirtualPathProvider con el sistema de compilación de ASP.NET.Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

SetCultures() SetCultures() SetCultures() SetCultures()

Establece el subproceso actual en la referencia cultural especificada en el archivo de configuración de la aplicación.Sets the current thread to the culture specified in the application configuration file.

SetCultures(String) SetCultures(String) SetCultures(String) SetCultures(String)

Establece el subproceso actual en la referencia cultural de la ruta de acceso virtual especificada.Sets the current thread to the culture of the specified virtual path.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject)

Quita un objeto de la lista de objetos registrados de la aplicación.Removes an object from the list of registered objects for the application.

Eventos

StopListening StopListening StopListening StopListening

[Se admite solo en .NET Framework 4.5.1][Supported in the .NET Framework 4.5.1 only]

Se produce cuando el proceso de trabajo o grupo de aplicaciones asociado a este host ha dejado de escuchar nuevas solicitudes y se apagará finalmente.Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

Se aplica a