HostingEnvironment Класс

Ссылка

Определение

Пространство имен:: System.Web.Hosting

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Обеспечивает функции управления для приложения и службы приложений для управляемого приложения в домене приложения. Этот класс не наследуется.

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

Наследование: Object

MarshalByRefObject
HostingEnvironment

Примеры

В следующем примере кода показана веб-страница, отображающая сведения о приложении, доступные 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)	Олицетворяет пользователя, представленного заданным токеном.
Impersonate(IntPtr, String)	Олицетворяет пользователя, указанного в установках конфигурации для конкретного виртуального пути или указанного маркера пользователя.
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]

Происходит, когда рабочий процесс или пул приложений, связанный с этим узлом, прекратил прослушивание новых запросов, и его работа будет в конечном счете завершена.

Применяется к