HostingEnvironment HostingEnvironment HostingEnvironment HostingEnvironment Class

정의

애플리케이션 도메인 내의 관리되는 애플리케이션에 애플리케이션 관리 함수와 애플리케이션 서비스를 제공합니다.Provides application-management functions and application services to a managed application within its application domain. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
상속
HostingEnvironmentHostingEnvironmentHostingEnvironmentHostingEnvironment

예제

다음 코드 예제는에서 제공 되는 애플리케이션 정보를 표시 하는 웹 페이지를 HostingEnvironment 개체입니다.The following code example is a webpage that displays the application information available from the HostingEnvironment object.

<%@ 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 애플리케이션 관리 기능 및 애플리케이션 서비스에 대 한 액세스를 제공 하는 클래스입니다.Each managed application domain contains a static instance of the HostingEnvironment class, which provides access to application-management functions and application services.

생성자

HostingEnvironment() HostingEnvironment() HostingEnvironment() HostingEnvironment()

HostingEnvironment 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the HostingEnvironment class.

속성

ApplicationHost ApplicationHost ApplicationHost ApplicationHost

이 속성은 ASP.NETASP.NET 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.This property supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

ApplicationID ApplicationID ApplicationID ApplicationID

애플리케이션의 고유 식별자를 가져옵니다.Gets the unique identifier of the application.

ApplicationMonitors ApplicationMonitors ApplicationMonitors ApplicationMonitors

애플리케이션 상태를 유지하기 위해 ASP.NET 하위 시스템에서 사용하는 대체 가능한 모니터 개체 그룹을 가져옵니다.Gets a group of replaceable monitor objects used by ASP.NET subsystems to maintain application health.

ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath ApplicationPhysicalPath

애플리케이션 디렉터리에 대한 디스크 상의 실제 경로를 가져옵니다.Gets the physical path on disk to the application's directory.

ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath ApplicationVirtualPath

애플리케이션의 루트 가상 경로를 가져옵니다.Gets the root virtual path of the application.

Cache Cache Cache Cache

현재 애플리케이션에 대한 Cache 인스턴스를 가져옵니다.Gets the Cache instance for the current application.

InClientBuildManager InClientBuildManager InClientBuildManager InClientBuildManager

호스팅 환경이 ASP.NET 빌드 시스템에 액세스할 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the hosting environment has access to the ASP.NET build system.

InitializationException InitializationException InitializationException InitializationException

HostingEnvironment 개체를 초기화하는 동안 throw된 예외를 가져옵니다.Gets any exception thrown during initialization of the HostingEnvironment object.

IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment IsDevelopmentEnvironment

현재 애플리케이션이 개발 환경에 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the current application is in a development environment.

IsHosted IsHosted IsHosted IsHosted

현재 애플리케이션 도메인이 ApplicationManager 개체에 의해 호스팅되는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the current application domain is being hosted by an ApplicationManager object.

MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU MaxConcurrentRequestsPerCPU

CPU당 최대 동시 요청 수를 가져오거나 설정합니다.Gets or sets the maximum concurrent requests per CPU.

MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU MaxConcurrentThreadsPerCPU

CPU당 최대 동시 스레드 수를 가져오거나 설정합니다.Gets or sets the maximum concurrent threads per CPU.

ShutdownReason ShutdownReason ShutdownReason ShutdownReason

애플리케이션이 종료된 이유를 나타내는 열거형 값을 반환합니다.Returns an enumerated value that indicates why the application terminated.

SiteName SiteName SiteName SiteName

사이트의 이름을 가져옵니다.Gets the name of the site.

VirtualPathProvider VirtualPathProvider VirtualPathProvider VirtualPathProvider

이 애플리케이션의 가상 경로 공급자를 가져옵니다.Gets the virtual path provider for this application.

메서드

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DecrementBusyCount() DecrementBusyCount() DecrementBusyCount() DecrementBusyCount()

호스팅된 환경에서 사용 중인 개체 수를 하나씩 줄입니다.Reduces the count of busy objects in the hosted environment by one.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
Impersonate() Impersonate() Impersonate() Impersonate()

애플리케이션 ID가 나타내는 사용자를 가장합니다.Impersonates the user represented by the application identity.

Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr) Impersonate(IntPtr)

지정된 사용자 토큰이 나타내는 사용자를 가장합니다.Impersonates the user represented by the specified user token.

Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String) Impersonate(IntPtr, String)

지정된 가상 경로를 위한 구성 설정에 의해 지정된 사용자 또는 지정된 사용자 토큰을 가장합니다.Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

IncrementBusyCount() IncrementBusyCount() IncrementBusyCount() IncrementBusyCount()

호스팅된 환경에서 사용 중인 개체 수를 하나씩 늘립니다.Increases the count of busy objects in the hosted environment by one.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

임대가 만들어지는 것을 방지하여 HostingEnvironment 개체에 영구 수명을 제공합니다.Gives the HostingEnvironment object an infinite lifetime by preventing a lease from being created.

InitiateShutdown() InitiateShutdown() InitiateShutdown() InitiateShutdown()

이 호스트와 연결된 웹 애플리케이션 종료를 시작하고 등록된 개체를 시스템에서 제거합니다.Starts shutting down the web application associated with this host and removes registered objects from the system.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

가상 경로를 서버의 실제 경로에 매핑합니다.Maps a virtual path to a physical path on the server.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MessageReceived() MessageReceived() MessageReceived() MessageReceived()

이 메서드는 ASP.NETASP.NET 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.This method supports the ASP.NETASP.NET infrastructure and is not intended to be used directly from your code.

QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>) QueueBackgroundWorkItem(Action<CancellationToken>)

모든 요청과 무관하게 백그라운드에서 실행할 수 있는 작업을 예약합니다.Schedules a task which can run in the background, independent of any request.

QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>) QueueBackgroundWorkItem(Func<CancellationToken,Task>)

모든 요청과 무관하게 백그라운드에서 실행할 수 있는 작업을 예약합니다.Schedules a task which can run in the background, independent of any request.

RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject) RegisterObject(IRegisteredObject)

애플리케이션의 등록된 개체 목록에 개체를 배치합니다.Places an object in the list of registered objects for the application.

RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider) RegisterVirtualPathProvider(VirtualPathProvider)

ASP.NET 컴파일 시스템에 새 VirtualPathProvider 인스턴스를 등록합니다.Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

SetCultures() SetCultures() SetCultures() SetCultures()

현재 스레드를 애플리케이션 구성 파일에 지정된 문화권으로 설정합니다.Sets the current thread to the culture specified in the application configuration file.

SetCultures(String) SetCultures(String) SetCultures(String) SetCultures(String)

현재 스레드를 지정된 가상 경로의 문화권으로 설정합니다.Sets the current thread to the culture of the specified virtual path.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject) UnregisterObject(IRegisteredObject)

애플리케이션의 등록된 개체 목록에서 개체를 제거합니다.Removes an object from the list of registered objects for the application.

이벤트

StopListening StopListening StopListening StopListening

[.NET Framework 4.5.1에서만 지원됨][Supported in the .NET Framework 4.5.1 only]

이 호스트와 연결된 작업자 프로세스 또는 애플리케이션 풀에서 새 요청 수신을 중지한 경우에 발생하며, 결국 요청 수신이 종료됩니다.Occurs when the worker process or application pool associated with this host has stopped listening for new requests and will eventually shut down.

적용 대상