Dil

HostingEnvironment Sınıf

Tanım

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 : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
Devralma
HostingEnvironment

Örnekler

Aşağıdaki kod örneği, nesneden sağlanan 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 ve uygulama hizmetlerine erişim sağlayan sınıfın HostingEnvironment statik bir örneğini içerir.

Oluşturucular

Name Description
HostingEnvironment()

HostingEnvironment sınıfının yeni bir örneğini başlatır.

Özellikler

Name Description
ApplicationHost

Bu özellik ASP.NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamış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 değiştirilebilir izleyici nesneleri grubunu 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ığını alır veya ayarlar.

ShutdownReason

Uygulamanın neden sonlandırıldığını gösteren numaralandırılmış bir 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

Name Description
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()
Geçersiz.

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()

Geçerli örneğin Type 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, 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.

Impersonate(IntPtr)

Belirtilen kullanıcı belirteci tarafından temsil edilen 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)

Sanal yolu sunucudaki fiziksel bir yola eşler.

MemberwiseClone()

Geçerli Objectbasit 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 isteklerden bağımsız olarak arka planda çalışabilen bir görev zamanlar.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Herhangi bir isteklerden 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)

yeni bir VirtualPathProvider örneğini ASP.NET derleme sistemine 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 bir dize döndürür.

(Devralındığı yer: Object)
UnregisterObject(IRegisteredObject)

Bir nesneyi uygulama için kayıtlı nesneler listesinden kaldırır.

Ekinlikler

Name Description
StopListening

[Yalnızca .NET Framework 4.5.1'de desteklenir]

Bu konakla ilişkili çalışan işlemi veya uygulama havuzu yeni istekleri dinlemeyi durdurduğunda ve sonunda kapandığında gerçekleşir.

Şunlara uygulanır