HostingEnvironment Classe

Referência

Definição

Namespace:: System.Web.Hosting

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece funções de gerenciamento de aplicativos e serviços de aplicativo para um aplicativo gerenciado em seu domínio de aplicativo. Essa classe não pode ser herdada.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Herança: Object

MarshalByRefObject
HostingEnvironment

Exemplos

O exemplo de código a seguir é uma página da Web que exibe as informações do aplicativo disponíveis no 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>

Comentários

Cada domínio de aplicativo gerenciado contém uma instância estática da HostingEnvironment classe, que fornece acesso a funções de gerenciamento de aplicativos e serviços de aplicativo.

Construtores

HostingEnvironment()

Inicializa uma nova instância da classe HostingEnvironment.

Propriedades

ApplicationHost	Essa propriedade dá suporte à infraestrutura ASP.NET e não se destina a ser usada diretamente do código.
ApplicationID	Obtém o identificador exclusivo do aplicativo.
ApplicationMonitors	Obtém um grupo de objetos de monitor substituíveis usados por subsistemas ASP.NET para manter a integridade do aplicativo.
ApplicationPhysicalPath	Obtém o caminho físico em disco para o diretório do aplicativo.
ApplicationVirtualPath	Obtém o caminho virtual raiz do aplicativo.
Cache	Obtém a instância Cache para o aplicativo atual.
InClientBuildManager	Obtém um valor que indica se o ambiente de hospedagem tem acesso ao sistema de build ASP.NET.
InitializationException	Obtém qualquer exceção lançada durante a inicialização do objeto HostingEnvironment.
IsDevelopmentEnvironment	Obtém um valor que indica se o aplicativo atual está em um ambiente de desenvolvimento.
IsHosted	Obtém um valor que indica se o domínio de aplicativo atual está sendo hospedado por um objeto ApplicationManager.
MaxConcurrentRequestsPerCPU	Obtém ou define o máximo de solicitações simultâneas por CPU.
MaxConcurrentThreadsPerCPU	Obtém ou define o máximo de threads simultâneos por CPU.
ShutdownReason	Retorna um valor enumerado que indica por que o aplicativo foi encerrado.
SiteName	Obtém o nome do site.
VirtualPathProvider	Obtém o provedor de caminho virtual desse aplicativo.

Métodos

CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
DecrementBusyCount()	Reduz a contagem de objetos ocupados no ambiente hospedado em um.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Impersonate()	Representa o usuário representado pela identidade do aplicativo.
Impersonate(IntPtr)	Representa o usuário representado pelo token de usuário especificado.
Impersonate(IntPtr, String)	Representa o usuário especificado pelas configurações do caminho virtual especificado ou do token de usuário especificado.
IncrementBusyCount()	Aumenta a contagem de objetos ocupados no ambiente hospedado em um.
InitializeLifetimeService()	Fornece ao objeto HostingEnvironment um tempo de vida infinito ao impedir que uma concessão seja criada.
InitiateShutdown()	Inicia o desligamento do aplicativo Web associado a esse host e remove objetos registrados do sistema.
MapPath(String)	Mapeia um caminho virtual para um caminho físico no servidor.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MessageReceived()	Esse método dá suporte à infraestrutura de ASP.NET e não se destina a ser usado diretamente do código.
QueueBackgroundWorkItem(Action<CancellationToken>)	Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	Agenda uma tarefa que pode ser executada em segundo plano, independente da solicitação.
RegisterObject(IRegisteredObject)	Coloca um objeto na lista de objetos registrados do aplicativo.
RegisterVirtualPathProvider(VirtualPathProvider)	Registra uma nova instância VirtualPathProvider com o sistema de compilação do ASP.NET.
SetCultures()	Define o thread atual para a cultura especificada no arquivo de configuração de aplicativo.
SetCultures(String)	Define o thread atual para a cultura do caminho virtual especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UnregisterObject(IRegisteredObject)	Remove um objeto da lista de objetos registrados do aplicativo.

Eventos

StopListening

[Suporte somente no .NET Framework 4.5.1]

Ocorre quando o processo de trabalho ou pool de aplicativos associado a este host parou de escutar novas solicitações e acabará sendo desligado.

Aplica-se a