HostingEnvironment Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Hosting

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object

MarshalByRefObject
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