HostingEnvironment Clase

Referencia

Definición

Espacio de nombres:: System.Web.Hosting

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona funciones de administración de aplicaciones y servicios de aplicación a aplicaciones administradas en sus dominios de aplicación. Esta clase no puede heredarse.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Herencia: Object

MarshalByRefObject
HostingEnvironment

Ejemplos

El siguiente ejemplo de código es una página web que muestra la información de la aplicación disponible en el HostingEnvironment objeto .

<%@ 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 administrada contiene una instancia estática de la HostingEnvironment clase , que proporciona acceso a las funciones de administración de aplicaciones y a los servicios de aplicación.

Constructores

HostingEnvironment()

Inicializa una nueva instancia de la clase HostingEnvironment.

Propiedades

ApplicationHost	Esta propiedad admite la infraestructura de ASP.NET y no está pensada para usarse directamente desde el código.
ApplicationID	Obtiene el identificador único de la aplicación.
ApplicationMonitors	Obtiene un grupo de objetos de supervisión reemplazables que usan los subsistemas ASP.NET para mantener el estado de la aplicación.
ApplicationPhysicalPath	Obtiene la ruta de acceso física en disco al directorio de la aplicación.
ApplicationVirtualPath	Obtiene la ruta de acceso virtual raíz de la aplicación.
Cache	Obtiene la instancia de Cache para la aplicación actual.
InClientBuildManager	Obtiene un valor que indica si el entorno de hospedaje tiene acceso al sistema de compilación de ASP.NET.
InitializationException	Obtiene las excepciones producidas durante la inicialización del objeto HostingEnvironment.
IsDevelopmentEnvironment	Obtiene un valor que indica si la aplicación actual está en un entorno de desarrollo.
IsHosted	Obtiene un valor que indica si un objeto ApplicationManager hospeda el dominio de aplicación actual.
MaxConcurrentRequestsPerCPU	Obtiene o establece el número máximo de solicitudes simultáneas por CPU.
MaxConcurrentThreadsPerCPU	Obtiene o establece el número máximo de subprocesos simultáneos por CPU.
ShutdownReason	Devuelve un valor enumerado que indica por qué ha finalizado la aplicación.
SiteName	Obtiene el nombre del sitio.
VirtualPathProvider	Obtiene el proveedor de la ruta de acceso virtual de esta aplicación.

Métodos

CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
DecrementBusyCount()	Reduce en uno el número de objetos ocupados en el entorno hospedado.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoleto. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Impersonate()	Suplanta al usuario representado por la identidad de aplicaciones.
Impersonate(IntPtr)	Suplanta al usuario representado por el token de usuario especificado.
Impersonate(IntPtr, String)	Suplanta al usuario definido por la configuración de la ruta de acceso virtual o el token de usuario que se hayan especificado.
IncrementBusyCount()	Aumenta en uno el número de objetos ocupados en el entorno hospedado.
InitializeLifetimeService()	Concede al objeto HostingEnvironment una duración infinita ya que impide que se genere una concesión.
InitiateShutdown()	Inicia el cierre de la aplicación web asociada a este host y quita los objetos registrados del sistema.
MapPath(String)	Asigna una ruta de acceso virtual a una ruta de acceso física en el servidor.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
MessageReceived()	Este método admite la infraestructura de ASP.NET y no está pensado para usarse directamente desde el código.
QueueBackgroundWorkItem(Action<CancellationToken>)	Programa una tarea que se puede ejecutar en segundo plano, independientemente de cualquier solicitud.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Programa una tarea que se puede ejecutar en segundo plano, independientemente de cualquier solicitud.
RegisterObject(IRegisteredObject)	Coloca un objeto en la lista de objetos registrados de la aplicación.
RegisterVirtualPathProvider(VirtualPathProvider)	Registra una nueva instancia de VirtualPathProvider con el sistema de compilación de ASP.NET.
SetCultures()	Establece el subproceso actual en la referencia cultural especificada en el archivo de configuración de la aplicación.
SetCultures(String)	Establece el subproceso actual en la referencia cultural de la ruta de acceso virtual especificada.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
UnregisterObject(IRegisteredObject)	Quita un objeto de la lista de objetos registrados de la aplicación.

Eventos

StopListening

[Solo es compatible con .NET Framework 4.5.1]

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.

Se aplica a

Compartir a través de