Udostępnij za pośrednictwem


HostingEnvironment Klasa

Definicja

Udostępnia funkcje zarządzania aplikacjami i usługi aplikacji do aplikacji zarządzanej w domenie aplikacji. Klasa ta nie może być dziedziczona.

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
Dziedziczenie
HostingEnvironment

Przykłady

Poniższy przykład kodu to strona internetowa, która wyświetla informacje o aplikacji dostępne z HostingEnvironment obiektu.

<%@ 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>

Uwagi

Każda domena aplikacji zarządzanej HostingEnvironment zawiera statyczne wystąpienie klasy, które zapewnia dostęp do funkcji zarządzania aplikacjami i usług aplikacji.

Konstruktory

HostingEnvironment()

Inicjuje nowe wystąpienie klasy HostingEnvironment.

Właściwości

ApplicationHost

Ta właściwość obsługuje infrastrukturę ASP.NET i nie jest przeznaczona do użycia bezpośrednio z kodu.

ApplicationID

Pobiera unikatowy identyfikator aplikacji.

ApplicationMonitors

Pobiera grupę zastępowalnych obiektów monitora używanych przez podsystemy ASP.NET w celu zachowania kondycji aplikacji.

ApplicationPhysicalPath

Pobiera ścieżkę fizyczną na dysku do katalogu aplikacji.

ApplicationVirtualPath

Pobiera główną ścieżkę wirtualną aplikacji.

Cache

Cache Pobiera wystąpienie bieżącej aplikacji.

InClientBuildManager

Pobiera wartość wskazującą, czy środowisko hostingu ma dostęp do systemu kompilacji ASP.NET.

InitializationException

Pobiera wszelkie wyjątki zgłaszane podczas inicjowania HostingEnvironment obiektu.

IsDevelopmentEnvironment

Pobiera wartość wskazującą, czy bieżąca aplikacja znajduje się w środowisku projektowym.

IsHosted

Pobiera wartość wskazującą, czy bieżąca domena aplikacji jest hostowana przez ApplicationManager obiekt.

MaxConcurrentRequestsPerCPU

Pobiera lub ustawia maksymalną liczbę współbieżnych żądań na procesor.

MaxConcurrentThreadsPerCPU

Pobiera lub ustawia maksymalne współbieżne wątki na procesor.

ShutdownReason

Zwraca wyliczonej wartości, która wskazuje, dlaczego aplikacja została zakończona.

SiteName

Pobiera nazwę witryny.

VirtualPathProvider

Pobiera dostawcę ścieżki wirtualnej dla tej aplikacji.

Metody

CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
DecrementBusyCount()

Zmniejsza liczbę zajętych obiektów w środowisku hostowanym przez jeden.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
Impersonate()

Personifikuje użytkownika reprezentowanego przez tożsamość aplikacji.

Impersonate(IntPtr)

Personifikuje użytkownika reprezentowanego przez określony token użytkownika.

Impersonate(IntPtr, String)

Personifikuje użytkownika określonego przez ustawienia konfiguracji dla określonej ścieżki wirtualnej lub określonego tokenu użytkownika.

IncrementBusyCount()

Zwiększa liczbę zajętych obiektów w środowisku hostowanym o jeden.

InitializeLifetimeService()

HostingEnvironment Daje obiektowi nieskończony okres istnienia, uniemożliwiając utworzenie dzierżawy.

InitiateShutdown()

Rozpoczyna zamykanie aplikacji internetowej skojarzonej z tym hostem i usuwa zarejestrowane obiekty z systemu.

MapPath(String)

Mapy ścieżkę wirtualną do ścieżki fizycznej na serwerze.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
MessageReceived()

Ta metoda obsługuje infrastrukturę ASP.NET i nie jest przeznaczona do użycia bezpośrednio z kodu.

QueueBackgroundWorkItem(Action<CancellationToken>)

Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Planuje zadanie, które może być uruchamiane w tle, niezależnie od dowolnego żądania.

RegisterObject(IRegisteredObject)

Umieszcza obiekt na liście zarejestrowanych obiektów dla aplikacji.

RegisterVirtualPathProvider(VirtualPathProvider)

Rejestruje nowe VirtualPathProvider wystąpienie w systemie kompilacji ASP.NET.

SetCultures()

Ustawia bieżący wątek na kulturę określoną w pliku konfiguracji aplikacji.

SetCultures(String)

Ustawia bieżący wątek na kulturę określonej ścieżki wirtualnej.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
UnregisterObject(IRegisteredObject)

Usuwa obiekt z listy zarejestrowanych obiektów dla aplikacji.

Zdarzenia

StopListening

[Obsługiwane tylko w programie .NET Framework 4.5.1]

Występuje, gdy proces roboczy lub pula aplikacji skojarzona z tym hostem przestała nasłuchiwać nowych żądań i ostatecznie zostanie zamknięta.

Dotyczy