HostingEnvironment 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
애플리케이션 도메인 내의 관리되는 애플리케이션에 애플리케이션 관리 함수와 애플리케이션 서비스를 제공합니다. 이 클래스는 상속될 수 없습니다.
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 개체를 초기화하는 동안 throw된 예외를 가져옵니다. |
| IsDevelopmentEnvironment |
현재 애플리케이션이 개발 환경에 있는지 여부를 나타내는 값을 가져옵니다. |
| IsHosted |
현재 애플리케이션 도메인이 ApplicationManager 개체에 의해 호스팅되는지 여부를 나타내는 값을 가져옵니다. |
| MaxConcurrentRequestsPerCPU |
CPU당 최대 동시 요청 수를 가져오거나 설정합니다. |
| MaxConcurrentThreadsPerCPU |
CPU당 최대 동시 스레드 수를 가져오거나 설정합니다. |
| ShutdownReason |
애플리케이션이 종료된 이유를 나타내는 열거형 값을 반환합니다. |
| SiteName |
사이트의 이름을 가져옵니다. |
| VirtualPathProvider |
이 애플리케이션의 가상 경로 공급자를 가져옵니다. |
메서드
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| DecrementBusyCount() |
호스팅된 환경에서 사용 중인 개체 수를 하나씩 줄입니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetLifetimeService() |
사용되지 않습니다.
이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| Impersonate() |
애플리케이션 ID가 나타내는 사용자를 가장합니다. |
| 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) |
ASP.NET 컴파일 시스템에 새 VirtualPathProvider 인스턴스를 등록합니다. |
| SetCultures() |
현재 스레드를 애플리케이션 구성 파일에 지정된 문화권으로 설정합니다. |
| SetCultures(String) |
현재 스레드를 지정된 가상 경로의 문화권으로 설정합니다. |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
| UnregisterObject(IRegisteredObject) |
애플리케이션의 등록된 개체 목록에서 개체를 제거합니다. |
이벤트
| StopListening |
[.NET Framework 4.5.1에서만 지원됨] 이 호스트와 연결된 작업자 프로세스 또는 애플리케이션 풀에서 새 요청 수신을 중지한 경우에 발생하며, 결국 요청 수신이 종료됩니다. |