HostingEnvironment Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Uygulama etki alanı içinde yönetilen bir uygulamaya uygulama yönetimi işlevleri ve uygulama hizmetleri sağlar. Bu sınıf devralınamaz.
public ref class HostingEnvironment sealed : MarshalByRefObjectpublic sealed class HostingEnvironment : MarshalByRefObjecttype HostingEnvironment = class
inherit MarshalByRefObjectPublic NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject- Devralma
Örnekler
Aşağıdaki kod örneği, nesneden edinilebilen uygulama bilgilerini görüntüleyen bir web sayfasıdır 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>
Açıklamalar
Her yönetilen uygulama etki alanı, uygulama yönetimi işlevlerine HostingEnvironment ve uygulama hizmetlerine erişim sağlayan sınıfının statik bir örneğini içerir.
Oluşturucular
| HostingEnvironment() |
HostingEnvironment sınıfının yeni bir örneğini başlatır. |
Özellikler
| ApplicationHost |
Bu özellik ASP.NET altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır. |
| ApplicationID |
Uygulamanın benzersiz tanımlayıcısını alır. |
| ApplicationMonitors |
Uygulama durumunu korumak için ASP.NET alt sistemleri tarafından kullanılan bir grup değiştirilebilir izleyici nesnesi alır. |
| ApplicationPhysicalPath |
Disk üzerindeki fiziksel yolu uygulamanın dizinine alır. |
| ApplicationVirtualPath |
Uygulamanın kök sanal yolunu alır. |
| Cache |
Cache Geçerli uygulamanın örneğini alır. |
| InClientBuildManager |
Barındırma ortamının ASP.NET derleme sistemine erişimi olup olmadığını gösteren bir değer alır. |
| InitializationException |
Nesnenin başlatılması HostingEnvironment sırasında oluşturulan özel durumları alır. |
| IsDevelopmentEnvironment |
Geçerli uygulamanın geliştirme ortamında olup olmadığını gösteren bir değer alır. |
| IsHosted |
Geçerli uygulama etki alanının bir nesne tarafından barındırılıp barındırılmadığını belirten bir ApplicationManager değer alır. |
| MaxConcurrentRequestsPerCPU |
CPU başına en fazla eşzamanlı isteği alır veya ayarlar. |
| MaxConcurrentThreadsPerCPU |
CPU başına en fazla eş zamanlı iş parçacığı sayısını alır veya ayarlar. |
| ShutdownReason |
Uygulamanın neden sonlandırıldığını gösteren bir numaralandırılmış değer döndürür. |
| SiteName |
Sitenin adını alır. |
| VirtualPathProvider |
Bu uygulama için sanal yol sağlayıcısını alır. |
Yöntemler
| CreateObjRef(Type) |
Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject) |
| DecrementBusyCount() |
Barındırılan ortamdaki meşgul nesnelerin sayısını bir azaltır. |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetLifetimeService() |
Kullanımdan kalktı.
Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject) |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| Impersonate() |
Uygulama kimliği tarafından temsil edilen kullanıcının kimliğine bürüner. |
| Impersonate(IntPtr) |
Belirtilen kullanıcı belirteci tarafından temsil edilen kullanıcının kimliğine bürüner. |
| Impersonate(IntPtr, String) |
Belirtilen sanal yol veya belirtilen kullanıcı belirteci için yapılandırma ayarları tarafından belirtilen kullanıcının kimliğine bürüner. |
| IncrementBusyCount() |
Barındırılan ortamdaki meşgul nesnelerin sayısını bir artırır. |
| InitializeLifetimeService() |
Kiralamanın oluşturulmasını HostingEnvironment engelleyerek nesneye sonsuz bir yaşam süresi verir. |
| InitiateShutdown() |
Bu konakla ilişkili web uygulamasını kapatmaya başlar ve kayıtlı nesneleri sistemden kaldırır. |
| MapPath(String) |
Sunucudaki fiziksel yola sanal bir yol Haritalar. |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
| MessageReceived() |
Bu yöntem ASP.NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. |
| QueueBackgroundWorkItem(Action<CancellationToken>) |
Herhangi bir istekte bağımsız olarak arka planda çalışabilen bir görev zamanlar. |
| QueueBackgroundWorkItem(Func<CancellationToken,Task>) |
Herhangi bir istekte bağımsız olarak arka planda çalışabilen bir görev zamanlar. |
| RegisterObject(IRegisteredObject) |
Bir nesneyi uygulama için kayıtlı nesneler listesine yerleştirir. |
| RegisterVirtualPathProvider(VirtualPathProvider) |
ASP.NET derleme sistemine yeni VirtualPathProvider bir örnek kaydeder. |
| SetCultures() |
Geçerli iş parçacığını uygulama yapılandırma dosyasında belirtilen kültüre ayarlar. |
| SetCultures(String) |
Geçerli iş parçacığını belirtilen sanal yolun kültürüne ayarlar. |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
| UnregisterObject(IRegisteredObject) |
Bir nesneyi uygulama için kayıtlı nesneler listesinden kaldırır. |
Ekinlikler
| StopListening |
[Yalnızca .NET Framework 4.5.1'de desteklenir] Bu konakla ilişkilendirilmiş çalışan işlemi veya uygulama havuzu yeni istekleri dinlemeyi durdurduğunda ve sonunda kapandığında gerçekleşir. |