Partilhar via


HostingEnvironment Classe

Definição

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