ServiceHost Osztály

Definíció

Névtér:

System.ServiceModel

Szerelvény:

System.ServiceModel.dll

Gazdagépet biztosít a szolgáltatásokhoz.

public ref class ServiceHost : System::ServiceModel::ServiceHostBase

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

Öröklődés

Object

CommunicationObject

ServiceHostBase

ServiceHost

Származtatott

System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

Példák

// Host the service within this EXE console application.
public static void Main()
{
  using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
  {
    try
    {
      // Open the ServiceHost to start listening for messages.
      serviceHost.Open();

        // The service can now be accessed.
      Console.WriteLine("The service is ready.");
      Console.WriteLine("Press <ENTER> to terminate service.");
      Console.ReadLine();

      // Close the ServiceHost.
      serviceHost.Close();
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine(timeProblem.Message);
      Console.ReadLine();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine(commProblem.Message);
      Console.ReadLine();
    }
  }
}

' Host the service within this EXE console application.
Public Shared Sub Main()
    ' Create a ServiceHost for the CalculatorService type and use the base address from config.
    Using svcHost As New ServiceHost(GetType(CalculatorService))
        Try
            ' Open the ServiceHost to start listening for messages.
            svcHost.Open()

            ' The service can now be accessed.
            Console.WriteLine("The service is ready.")
            Console.WriteLine("Press <ENTER> to terminate service.")
            Console.WriteLine()
            Console.ReadLine()

            'Close the ServiceHost.
            svcHost.Close()

        Catch timeout As TimeoutException
            Console.WriteLine(timeout.Message)
            Console.ReadLine()
        Catch commException As CommunicationException
            Console.WriteLine(commException.Message)
            Console.ReadLine()
        End Try
    End Using

End Sub

Megjegyzések

Implementálja a Windows kommunikációs alaprendszer (WCF) szolgáltatásmodell programozási modellje által használt gazdagépet.

A ServiceHost osztály használatával konfigurálhat és közzétehet egy szolgáltatást az ügyfélalkalmazások számára, ha nem Internet Information Services (IIS) vagy Windows Aktiválási szolgáltatások (WAS) használatával teszi elérhetővé a szolgáltatást. Az IIS és a WAS is együttműködik egy ServiceHost objektummal az Ön nevében.

Ahhoz, hogy a hívók elérhetővé tegyenek egy szolgáltatást, a WCF-nek teljes körű szolgáltatásleírásra van szüksége (amelyet az ServiceDescription osztály jelöl). Az ServiceHost osztály létrehoz egy ServiceDescription szolgáltatást a szolgáltatástípus és a konfigurációs információk alapján, majd ezt a leírást használva objektumokat hoz létre ChannelDispatcher az egyes végpontokhoz a leírásban.

Objektum használatával ServiceHost betölthet egy szolgáltatást, konfigurálhatja a végpontokat, biztonsági beállításokat alkalmazhat, és elindíthatja a figyelőket a bejövő kérések kezeléséhez.

Konstruktorok

Név	Description
ServiceHost()	Inicializálja a ServiceHost osztály új példányát.
ServiceHost(Object, Uri[])	Inicializálja az ServiceHost osztály új példányát a szolgáltatás példányával és annak alapcímeivel.
ServiceHost(Type, Uri[])	Inicializálja az ServiceHost osztály új példányát a szolgáltatás típusával és a megadott alapcímekkel.

Tulajdonságok

Név	Description
Authentication	Lekéri a szolgáltatáshitelesítési viselkedést. (Öröklődés forrása ServiceHostBase)
Authorization	Lekéri a üzemeltetett szolgáltatás engedélyezési viselkedését. (Öröklődés forrása ServiceHostBase)
BaseAddresses	Lekéri a üzemeltetett szolgáltatás által használt alapcímeket. (Öröklődés forrása ServiceHostBase)
ChannelDispatchers	Lekéri a szolgáltatásgazda által használt csatornaelosztók gyűjteményét. (Öröklődés forrása ServiceHostBase)
CloseTimeout	Lekéri vagy beállítja a szolgáltatásgazda bezárásához engedélyezett időintervallumot. (Öröklődés forrása ServiceHostBase)
Credentials	Lekéri az üzemeltetett szolgáltatás hitelesítő adatait. (Öröklődés forrása ServiceHostBase)
DefaultCloseTimeout	A szolgáltatás gazdagép bezárásához engedélyezett alapértelmezett időintervallumot kapja meg. (Öröklődés forrása ServiceHostBase)
DefaultOpenTimeout	A szolgáltatás gazdagépének megnyitásához engedélyezett alapértelmezett időintervallumot kapja meg. (Öröklődés forrása ServiceHostBase)
Description	Lekéri a üzemeltetett szolgáltatás leírását. (Öröklődés forrása ServiceHostBase)
Extensions	Lekéri az aktuálisan megadott szolgáltatásgazda bővítményeit. (Öröklődés forrása ServiceHostBase)
ImplementedContracts	Lekéri a üzemeltetett szolgáltatás által végrehajtott szerződéseket. (Öröklődés forrása ServiceHostBase)
IsDisposed	Olyan értéket kap, amely jelzi, hogy a kommunikációs objektum el lett-e adva. (Öröklődés forrása CommunicationObject)
ManualFlowControlLimit	Lekéri vagy beállítja az üzemeltetett szolgáltatás által fogadott üzenetek folyamatvezérlési korlátját. (Öröklődés forrása ServiceHostBase)
OpenTimeout	Lekéri vagy beállítja a szolgáltatás gazdagép megnyitásához engedélyezett időintervallumot. (Öröklődés forrása ServiceHostBase)
SingletonInstance	Lekéri az üzemeltetett szolgáltatás egyszeri példányát.
State	Lekéri a kommunikációs objektum aktuális állapotát jelző értéket. (Öröklődés forrása CommunicationObject)
ThisLock	Lekéri a kölcsönösen kizáró zárolást, amely az osztálypéldányt védi az állapotváltás során. (Öröklődés forrása CommunicationObject)

Metódusok

Név	Description
Abort()	A kommunikációs objektum a jelenlegi állapotából azonnal a záró állapotba kerül. (Öröklődés forrása CommunicationObject)
AddBaseAddress(Uri)	Alapcímet ad hozzá a szolgáltatás gazdagépéhez. (Öröklődés forrása ServiceHostBase)
AddDefaultEndpoints()	Szolgáltatásvégpontokat ad hozzá az alapértelmezett kötéssel rendelkező szolgáltatás gazdagépen található összes szerződés összes alapcíméhez. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	Hozzáadja a megadott szolgáltatásvégpontot a üzemeltetett szolgáltatáshoz. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel, végpontcímmel és URI-val, amely tartalmazza a figyelés címét. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel és végpontcímmel. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz a végpontot és a figyelési címeket tartalmazó megadott szerződéssel, kötéssel és URI-kkal. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel és a végpontcímet tartalmazó URI-val. (Öröklődés forrása ServiceHostBase)
AddServiceEndpoint(Type, Binding, String, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel, végpontcímmel és egy URI-val, amelyre a szolgáltatás figyel.
AddServiceEndpoint(Type, Binding, String)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel és végpontcímmel.
AddServiceEndpoint(Type, Binding, Uri, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel, a végpont címét tartalmazó URI-val és egy URI-val, amelyre a szolgáltatás figyel.
AddServiceEndpoint(Type, Binding, Uri)	Szolgáltatásvégpontot ad hozzá az üzemeltetett szolgáltatáshoz egy megadott szerződéssel, kötéssel és URI-val, amely tartalmazza a végpont címét.
ApplyConfiguration()	Betölti a szolgáltatás leírását a konfigurációs fájlból, és alkalmazza a létrehozott futtatókörnyezetre.
BeginClose(AsyncCallback, Object)	Elindít egy aszinkron műveletet egy kommunikációs objektum bezárásához. (Öröklődés forrása CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Elindít egy aszinkron műveletet egy kommunikációs objektum meghatározott időtúllépéssel történő bezárásához. (Öröklődés forrása CommunicationObject)
BeginOpen(AsyncCallback, Object)	Elindít egy aszinkron műveletet egy kommunikációs objektum megnyitásához. (Öröklődés forrása CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Elindít egy aszinkron műveletet egy kommunikációs objektum meghatározott időintervallumon belüli megnyitásához. (Öröklődés forrása CommunicationObject)
Close()	A kommunikációs objektum áttér az aktuális állapotáról a zárt állapotba. (Öröklődés forrása CommunicationObject)
Close(TimeSpan)	A kommunikációs objektum az aktuális állapotáról egy meghatározott időintervallumon belül zárt állapotba vált. (Öröklődés forrása CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	Létrehozza a üzemeltetett szolgáltatás leírását.
EndClose(IAsyncResult)	Befejez egy aszinkron műveletet egy kommunikációs objektum bezárásához. (Öröklődés forrása CommunicationObject)
EndOpen(IAsyncResult)	Befejez egy aszinkron műveletet egy kommunikációs objektum megnyitásához. (Öröklődés forrása CommunicationObject)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Fault()	A kommunikációs objektum az aktuális állapotából a hibás állapotba vált. (Öröklődés forrása CommunicationObject)
GetCommunicationObjectType()	Lekéri a kommunikációs objektum típusát. (Öröklődés forrása CommunicationObject)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IncrementManualFlowControlLimit(Int32)	Egy megadott növekménysel növeli a üzemeltetett szolgáltatásba küldött üzenetek átviteli sebességére vonatkozó korlátot. (Öröklődés forrása ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	Inicializálja a példány és a megadott alapcímek alapján üzemeltetett szolgáltatás leírását.
InitializeDescription(Type, UriSchemeKeyedCollection)	Inicializálja a üzemeltetett szolgáltatás leírását a típus és a megadott alapcímek alapján.
InitializeDescription(UriSchemeKeyedCollection)	Létrehozza és inicializálja a szolgáltatás gazdagépét a szerződéssel és a szolgáltatás leírásával. (Öröklődés forrása ServiceHostBase)
InitializeRuntime()	Inicializálja a szolgáltatásgazda futtatókörnyezetét. (Öröklődés forrása ServiceHostBase)
LoadConfigurationSection(ServiceElement)	Betölti a szolgáltatáselemet a üzemeltetett szolgáltatás konfigurációs fájljából. (Öröklődés forrása ServiceHostBase)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnAbort()	Megszakítja a szolgáltatást. (Öröklődés forrása ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Elindít egy aszinkron műveletet, amelyet a szolgáltatásgazda bezárása után hív meg. (Öröklődés forrása ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Elindít egy aszinkron műveletet, amelyet a szolgáltatásgazda megnyitásakor hív meg. (Öröklődés forrása ServiceHostBase)
OnClose(TimeSpan)	Bezárja az üzemeltetett szolgáltatást, beleértve a csatorna diszpécsereit, valamint a társított példánykörnyezeteket és figyelőket. (Öröklődés forrása ServiceHostBase)
OnClosed()	A szolgáltatásgazda bezárásakor üzemeltetett eldobható szolgáltatások megsemmisítése.
OnClosing()	A kommunikációs objektum záró állapotba való áttűnése során hívható meg. (Öröklődés forrása CommunicationObject)
OnEndClose(IAsyncResult)	Befejez egy aszinkron műveletet, amelyet a szolgáltatásgazda bezárása után hív meg. (Öröklődés forrása ServiceHostBase)
OnEndOpen(IAsyncResult)	Befejez egy aszinkron műveletet, amelyet a szolgáltatásgazda megnyitásakor hív meg. (Öröklődés forrása ServiceHostBase)
OnFaulted()	Beszúrja a feldolgozást egy kommunikációs objektumra, miután egy szinkron hibaművelet meghívása miatt a hibás állapotba vált. (Öröklődés forrása CommunicationObject)
OnOpen(TimeSpan)	Megnyitja a csatorna diszpécsereket. (Öröklődés forrása ServiceHostBase)
OnOpened()	Lekéri az üzemeltetett szolgáltatáshoz tartozó szolgáltatás hitelesítő adatait, szolgáltatáshitelesítését és engedélyezési viselkedését. (Öröklődés forrása ServiceHostBase)
OnOpening()	A kommunikációs objektum megnyitási állapotba való áttűnése során hívható meg. (Öröklődés forrása CommunicationObject)
Open()	Egy kommunikációs objektum a létrehozott állapotból a megnyitott állapotba vált. (Öröklődés forrása CommunicationObject)
Open(TimeSpan)	Egy kommunikációs objektum egy meghatározott időtartamon belül átvált a létrehozott állapotról a megnyitott állapotra. (Öröklődés forrása CommunicationObject)
ReleasePerformanceCounters()	Felszabadítja a szolgáltatás és a csatorna diszpécserének teljesítményszámlálóit az üzemeltetett szolgáltatáshoz. (Öröklődés forrása ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	Beállítja a megadott végpont végpontcímét a megadott címre. (Öröklődés forrása ServiceHostBase)
ThrowIfDisposed()	Kivételt jelez, ha a kommunikációs objektum el van dobva. (Öröklődés forrása CommunicationObject)
ThrowIfDisposedOrImmutable()	Kivételt jelez, ha a tulajdonság kommunikációs objektuma State nincs állapotra Created állítva. (Öröklődés forrása CommunicationObject)
ThrowIfDisposedOrNotOpen()	Kivételt jelez, ha a kommunikációs objektum nincs állapotban Opened . (Öröklődés forrása CommunicationObject)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

esemény

Név	Description
Closed	Akkor fordul elő, ha egy kommunikációs objektum zárt állapotba vált. (Öröklődés forrása CommunicationObject)
Closing	Akkor fordul elő, ha egy kommunikációs objektum a záró állapotba vált. (Öröklődés forrása CommunicationObject)
Faulted	Akkor fordul elő, ha egy kommunikációs objektum hibás állapotba vált. (Öröklődés forrása CommunicationObject)
Opened	Akkor fordul elő, ha egy kommunikációs objektum áttűnés a megnyitott állapotba. (Öröklődés forrása CommunicationObject)
Opening	Akkor fordul elő, ha egy kommunikációs objektum áttűnés a nyitó állapotba. (Öröklődés forrása CommunicationObject)
UnknownMessageReceived	Ismeretlen üzenet érkezésekor fordul elő. (Öröklődés forrása ServiceHostBase)

Explicit interfész-implementációk

Név	Description
IDisposable.Dispose()	Bezárja a szolgáltatás gazdagépét. (Öröklődés forrása ServiceHostBase)