HostingEnvironment Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет функции управления приложениями и службы приложений управляемому приложению в своем домене приложения. Этот класс не наследуется.
public ref class HostingEnvironment sealed : MarshalByRefObjectpublic sealed class HostingEnvironment : MarshalByRefObjecttype HostingEnvironment = class
inherit MarshalByRefObjectPublic NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject- Наследование
Примеры
В следующем примере кода показана веб-страница, которая отображает сведения о приложении, доступные HostingEnvironment из объекта.
<%@ 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>
Комментарии
Каждый домен управляемого HostingEnvironment приложения содержит статический экземпляр класса, который предоставляет доступ к функциям управления приложениями и службам приложений.
Конструкторы
| Имя | Описание |
|---|---|
| HostingEnvironment() |
Инициализирует новый экземпляр класса HostingEnvironment. |
Свойства
| Имя | Описание |
|---|---|
| ApplicationHost |
Это свойство поддерживает инфраструктуру ASP.NET и не предназначено для использования непосредственно из кода. |
| ApplicationID |
Возвращает уникальный идентификатор приложения. |
| ApplicationMonitors |
Возвращает группу заменяемых объектов мониторинга, используемых подсистемами ASP.NET для поддержания работоспособности приложений. |
| ApplicationPhysicalPath |
Получает физический путь на диске в каталог приложения. |
| ApplicationVirtualPath |
Возвращает корневой виртуальный путь приложения. |
| Cache |
Cache Возвращает экземпляр текущего приложения. |
| InClientBuildManager |
Возвращает значение, указывающее, имеет ли среда размещения доступ к системе сборки ASP.NET. |
| InitializationException |
Возвращает любое исключение, возникающее во время инициализации HostingEnvironment объекта. |
| IsDevelopmentEnvironment |
Возвращает значение, указывающее, находится ли текущее приложение в среде разработки. |
| IsHosted |
Возвращает значение, указывающее, размещается ли текущий ApplicationManager домен приложения объектом. |
| MaxConcurrentRequestsPerCPU |
Возвращает или задает максимальное количество одновременных запросов на ЦП. |
| MaxConcurrentThreadsPerCPU |
Возвращает или задает максимальное число параллельных потоков на ЦП. |
| ShutdownReason |
Возвращает перечисленное значение, указывающее, почему приложение завершило работу. |
| SiteName |
Возвращает имя сайта. |
| VirtualPathProvider |
Возвращает поставщик виртуального пути для этого приложения. |
Методы
| Имя | Описание |
|---|---|
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| DecrementBusyCount() |
Уменьшает количество занятых объектов в размещенной среде по одному. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Impersonate() |
Олицетворяет пользователя, представленного удостоверением приложения. |
| Impersonate(IntPtr, String) |
Олицетворяет пользователя, указанного параметрами конфигурации для указанного виртуального пути или указанного маркера пользователя. |
| Impersonate(IntPtr) |
Олицетворяет пользователя, представленного указанным маркером пользователя. |
| IncrementBusyCount() |
Увеличивает количество занятых объектов в размещенной среде на один. |
| InitializeLifetimeService() |
HostingEnvironment Дает объекту бесконечное время существования, предотвращая создание аренды. |
| InitiateShutdown() |
Начинает завершение работы веб-приложения, связанного с этим узлом, и удаляет зарегистрированные объекты из системы. |
| MapPath(String) |
Сопоставляет виртуальный путь с физическим путем на сервере. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject) |
| MessageReceived() |
Этот метод поддерживает инфраструктуру ASP.NET и не предназначен для использования непосредственно из кода. |
| QueueBackgroundWorkItem(Action<CancellationToken>) |
Планирует задачу, которая может выполняться в фоновом режиме независимо от любого запроса. |
| QueueBackgroundWorkItem(Func<CancellationToken,Task>) |
Планирует задачу, которая может выполняться в фоновом режиме независимо от любого запроса. |
| RegisterObject(IRegisteredObject) |
Помещает объект в список зарегистрированных объектов для приложения. |
| RegisterVirtualPathProvider(VirtualPathProvider) |
Регистрирует новый экземпляр VirtualPathProvider в системе компиляции ASP.NET. |
| SetCultures() |
Задает текущий поток язык и региональные параметры, указанные в файле конфигурации приложения. |
| SetCultures(String) |
Задает текущий поток языку и региональных параметров указанного виртуального пути. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| UnregisterObject(IRegisteredObject) |
Удаляет объект из списка зарегистрированных объектов для приложения. |
События
| Имя | Описание |
|---|---|
| StopListening |
[Поддерживается только в .NET Framework 4.5.1] Происходит, когда рабочий процесс или пул приложений, связанный с этим узлом, перестал прослушивать новые запросы и в конечном итоге завершит работу. |
