HostingEnvironment Classe
Definição
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 dentro de seu domínio de aplicativo. Essa classe não pode ser herdada.
public ref class HostingEnvironment sealed : MarshalByRefObjectpublic sealed class HostingEnvironment : MarshalByRefObjecttype HostingEnvironment = class
inherit MarshalByRefObjectPublic NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject- Herança
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
| Nome | Description |
|---|---|
| HostingEnvironment() |
Inicializa uma nova instância da classe HostingEnvironment. |
Propriedades
| Nome | Description |
|---|---|
| ApplicationHost |
Essa propriedade dá suporte à infraestrutura de ASP.NET e não se destina a ser usada diretamente do seu 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 no disco para o diretório do aplicativo. |
| ApplicationVirtualPath |
Obtém o caminho virtual raiz do aplicativo. |
| Cache |
Obtém a Cache instância do 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 gerada durante a inicialização do HostingEnvironment objeto. |
| 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 do aplicativo atual está sendo hospedado por um ApplicationManager objeto. |
| 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 para este aplicativo. |
Métodos
| Nome | Description |
|---|---|
| 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 hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa 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, String) |
Representa o usuário especificado pelas configurações do caminho virtual especificado ou do token de usuário especificado. |
| Impersonate(IntPtr) |
Representa o usuário representado pelo token de usuário especificado. |
| IncrementBusyCount() |
Aumenta a contagem de objetos ocupados no ambiente hospedado em um. |
| InitializeLifetimeService() |
Dá ao HostingEnvironment objeto um tempo de vida infinito impedindo que uma concessão seja criada. |
| InitiateShutdown() |
Começa a desligar o 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 Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MessageReceived() |
Esse método dá suporte à infraestrutura de ASP.NET e não se destina a ser usado diretamente do seu código. |
| QueueBackgroundWorkItem(Action<CancellationToken>) |
Agenda uma tarefa que pode ser executada em segundo plano, independentemente de qualquer solicitação. |
| QueueBackgroundWorkItem(Func<CancellationToken,Task>) |
Agenda uma tarefa que pode ser executada em segundo plano, independentemente de qualquer solicitação. |
| RegisterObject(IRegisteredObject) |
Coloca um objeto na lista de objetos registrados para o aplicativo. |
| RegisterVirtualPathProvider(VirtualPathProvider) |
Registra uma nova instância VirtualPathProvider com o sistema de compilação ASP.NET. |
| SetCultures() |
Define o thread atual para a cultura especificada no arquivo de configuração do 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 para o aplicativo. |
Eventos
| Nome | Description |
|---|---|
| StopListening |
[Com suporte somente no .NET Framework 4.5.1] Ocorre quando o processo de trabalho ou pool de aplicativos associado a esse host parou de escutar novas solicitações e, eventualmente, será desligado. |