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 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.

Şunlara uygulanır