Compartir vía


HostingEnvironment Clase

Definición

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
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