ServiceHost Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een host voor services.
public ref class ServiceHost : System::ServiceModel::ServiceHostBase
public class ServiceHost : System.ServiceModel.ServiceHostBase
type ServiceHost = class
inherit ServiceHostBase
Public Class ServiceHost
Inherits ServiceHostBase
- Overname
- Afgeleid
Voorbeelden
// 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
Opmerkingen
Implementeert de host die wordt gebruikt door het servicemodelprogrammeermodel van de Windows Communication Foundation (WCF).
Gebruik de klasse ServiceHost om een service te configureren en beschikbaar te maken voor gebruik door clienttoepassingen wanneer u geen gebruik maakt van Internet Information Services (IIS) of Windows Activation Services (WAS) om een service beschikbaar te maken. Zowel IIS als WAS communiceren met een ServiceHost object namens u.
Als u een service beschikbaar wilt maken voor gebruik door bellers, vereist WCF een volledige servicebeschrijving (vertegenwoordigd door de ServiceDescription klasse). De ServiceHost klasse maakt een ServiceDescription van het servicetype en de configuratiegegevens en gebruikt vervolgens die beschrijving om objecten te maken ChannelDispatcher voor elk eindpunt in de beschrijving.
Gebruik een ServiceHost object om een service te laden, eindpunten te configureren, beveiligingsinstellingen toe te passen en listeners te starten om binnenkomende aanvragen te verwerken.
Constructors
| Name | Description |
|---|---|
| ServiceHost() |
Initialiseert een nieuw exemplaar van de ServiceHost klasse. |
| ServiceHost(Object, Uri[]) |
Initialiseert een nieuw exemplaar van de ServiceHost klasse met het exemplaar van de service en de opgegeven basisadressen. |
| ServiceHost(Type, Uri[]) |
Initialiseert een nieuw exemplaar van de ServiceHost klasse met het type service en de opgegeven basisadressen. |
Eigenschappen
| Name | Description |
|---|---|
| Authentication |
Hiermee haalt u het verificatiegedrag van de service op. (Overgenomen van ServiceHostBase) |
| Authorization |
Hiermee haalt u het autorisatiegedrag voor de gehoste service op. (Overgenomen van ServiceHostBase) |
| BaseAddresses |
Hiermee haalt u de basisadressen op die worden gebruikt door de gehoste service. (Overgenomen van ServiceHostBase) |
| ChannelDispatchers |
Hiermee haalt u de verzameling kanaal-dispatchers op die door de servicehost worden gebruikt. (Overgenomen van ServiceHostBase) |
| CloseTimeout |
Hiermee haalt u het tijdsinterval op dat is toegestaan om de servicehost te sluiten of stelt u deze in. (Overgenomen van ServiceHostBase) |
| Credentials |
Hiermee haalt u de referentie op voor de service die wordt gehost. (Overgenomen van ServiceHostBase) |
| DefaultCloseTimeout |
Hiermee haalt u het standaardinterval op dat is toegestaan om de servicehost te sluiten. (Overgenomen van ServiceHostBase) |
| DefaultOpenTimeout |
Hiermee haalt u het standaardinterval op dat is toegestaan voor de servicehost om te openen. (Overgenomen van ServiceHostBase) |
| Description |
Hiermee wordt de beschrijving opgehaald van de service die wordt gehost. (Overgenomen van ServiceHostBase) |
| Extensions |
Hiermee haalt u de extensies voor de huidige opgegeven servicehost op. (Overgenomen van ServiceHostBase) |
| ImplementedContracts |
Haalt de contracten op die zijn geïmplementeerd door de service die wordt gehost. (Overgenomen van ServiceHostBase) |
| IsDisposed |
Hiermee wordt een waarde opgehaald die aangeeft of het communicatieobject is verwijderd. (Overgenomen van CommunicationObject) |
| ManualFlowControlLimit |
Hiermee wordt de limiet voor stroombeheer opgehaald of ingesteld voor berichten die worden ontvangen door de service die wordt gehost. (Overgenomen van ServiceHostBase) |
| OpenTimeout |
Hiermee haalt u het tijdsinterval op dat is toegestaan voor de servicehost om te openen. (Overgenomen van ServiceHostBase) |
| SingletonInstance |
Hiermee haalt u het singleton-exemplaar van de gehoste service op. |
| State |
Hiermee wordt een waarde opgehaald die de huidige status van het communicatieobject aangeeft. (Overgenomen van CommunicationObject) |
| ThisLock |
Hiermee haalt u de wederzijds exclusieve vergrendeling op die het klasse-exemplaar beschermt tijdens een statusovergang. (Overgenomen van CommunicationObject) |
Methoden
| Name | Description |
|---|---|
| Abort() |
Zorgt ervoor dat een communicatieobject onmiddellijk van de huidige status overgaat naar de slotstatus. (Overgenomen van CommunicationObject) |
| AddBaseAddress(Uri) |
Voegt een basisadres toe aan de servicehost. (Overgenomen van ServiceHostBase) |
| AddDefaultEndpoints() |
Voegt service-eindpunten toe voor alle basisadressen in elk contract dat is gevonden in de servicehost met de standaardbinding. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(ServiceEndpoint) |
Hiermee voegt u het opgegeven service-eindpunt toe aan de gehoste service. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(String, Binding, String, Uri) |
Voegt een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding, eindpuntadres en URI die het adres bevat waarop het luistert. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(String, Binding, String) |
Hiermee voegt u een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding en eindpuntadres. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(String, Binding, Uri, Uri) |
Hiermee voegt u een service-eindpunt toe aan de gehoste service met het opgegeven contract, de binding en de URI's die het eindpunt en de luisteradressen bevatten. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(String, Binding, Uri) |
Voegt een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding en een URI die het eindpuntadres bevat. (Overgenomen van ServiceHostBase) |
| AddServiceEndpoint(Type, Binding, String, Uri) |
Voegt een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding, een eindpuntadres en een URI waarop de service luistert. |
| AddServiceEndpoint(Type, Binding, String) |
Hiermee voegt u een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding en eindpuntadres. |
| AddServiceEndpoint(Type, Binding, Uri, Uri) |
Voegt een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding, een URI die het eindpuntadres bevat en een URI waarop de service luistert. |
| AddServiceEndpoint(Type, Binding, Uri) |
Voegt een service-eindpunt toe aan de gehoste service met een opgegeven contract, binding en URI die het eindpuntadres bevat. |
| ApplyConfiguration() |
Laadt de servicebeschrijving van het configuratiebestand en past deze toe op de runtime die wordt gemaakt. |
| ApplyConfiguration() |
Laadt de beschrijvingsgegevens van de service uit het configuratiebestand en past deze toe op de runtime die wordt gemaakt. (Overgenomen van ServiceHostBase) |
| BeginClose(AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject te sluiten. (Overgenomen van CommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart om een communicatieobject met een opgegeven time-out te sluiten. (Overgenomen van CommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van CommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject binnen een opgegeven tijdsinterval te openen. (Overgenomen van CommunicationObject) |
| Close() |
Zorgt ervoor dat een communicatieobject van de huidige status overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| Close(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de huidige status overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| CreateDescription(IDictionary<String,ContractDescription>) |
Hiermee maakt u een beschrijving van de service die wordt gehost. |
| EndClose(IAsyncResult) |
Hiermee voltooit u een asynchrone bewerking om een communicatieobject te sluiten. (Overgenomen van CommunicationObject) |
| EndOpen(IAsyncResult) |
Voltooit een asynchrone bewerking om een communicatieobject te openen. (Overgenomen van CommunicationObject) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| Fault() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de huidige status naar de foutieve status. (Overgenomen van CommunicationObject) |
| GetCommunicationObjectType() |
Hiermee wordt het type communicatieobject opgehaald. (Overgenomen van CommunicationObject) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IncrementManualFlowControlLimit(Int32) |
Hiermee verhoogt u de limiet voor de stroomsnelheid van berichten naar de gehoste service met een opgegeven verhoging. (Overgenomen van ServiceHostBase) |
| InitializeDescription(Object, UriSchemeKeyedCollection) |
Initialiseert een beschrijving van de service die wordt gehost op basis van het exemplaar en de opgegeven basisadressen. |
| InitializeDescription(Type, UriSchemeKeyedCollection) |
Initialiseert een beschrijving van de service die wordt gehost op basis van het type en de opgegeven basisadressen. |
| InitializeDescription(UriSchemeKeyedCollection) |
Hiermee maakt en initialiseert u de servicehost met de contract- en servicebeschrijvingen. (Overgenomen van ServiceHostBase) |
| InitializeRuntime() |
Initialiseert de runtime voor de servicehost. (Overgenomen van ServiceHostBase) |
| LoadConfigurationSection(ServiceElement) |
Laadt het service-element uit het configuratiebestand van de gehoste service. (Overgenomen van ServiceHostBase) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| OnAbort() |
De service wordt afgebroken. (Overgenomen van ServiceHostBase) |
| OnBeginClose(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart die wordt aangeroepen bij het sluiten van de servicehost. (Overgenomen van ServiceHostBase) |
| OnBeginOpen(TimeSpan, AsyncCallback, Object) |
Hiermee wordt een asynchrone bewerking gestart die wordt aangeroepen bij het openen van de servicehost. (Overgenomen van ServiceHostBase) |
| OnClose(TimeSpan) |
Hiermee sluit u de gehoste service, inclusief de kanaaldispatchers en de bijbehorende instantiecontexten en listeners. (Overgenomen van ServiceHostBase) |
| OnClosed() |
Verwijdert wegwerpservices die worden gehost wanneer de servicehost wordt gesloten. |
| OnClosing() |
Aangeroepen tijdens de overgang van een communicatieobject in de slotstatus. (Overgenomen van CommunicationObject) |
| OnEndClose(IAsyncResult) |
Hiermee wordt een asynchrone bewerking voltooid die wordt aangeroepen bij het sluiten van de servicehost. (Overgenomen van ServiceHostBase) |
| OnEndOpen(IAsyncResult) |
Hiermee wordt een asynchrone bewerking voltooid die is aangeroepen bij het openen van de servicehost. (Overgenomen van ServiceHostBase) |
| OnFaulted() |
Hiermee wordt de verwerking van een communicatieobject ingevoegd nadat het is overgeschakeld naar de status Met fouten als gevolg van de aanroep van een synchrone foutbewerking. (Overgenomen van CommunicationObject) |
| OnOpen(TimeSpan) |
Hiermee opent u de kanaalzenders. (Overgenomen van ServiceHostBase) |
| OnOpened() |
Hiermee haalt u de servicereferenties, serviceverificatie en autorisatiegedrag voor de gehoste service op. (Overgenomen van ServiceHostBase) |
| OnOpening() |
Aangeroepen tijdens de overgang van een communicatieobject in de openingsstatus. (Overgenomen van CommunicationObject) |
| Open() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status. (Overgenomen van CommunicationObject) |
| Open(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de gemaakte status overgaat naar de geopende status. (Overgenomen van CommunicationObject) |
| ReleasePerformanceCounters() |
Hiermee worden de prestatiemeteritems voor de service en kanaalzender uitgebracht voor de gehoste service. (Overgenomen van ServiceHostBase) |
| SetEndpointAddress(ServiceEndpoint, String) |
Hiermee stelt u het eindpuntadres van het opgegeven eindpunt in op het opgegeven adres. (Overgenomen van ServiceHostBase) |
| ThrowIfDisposed() |
Genereert een uitzondering als het communicatieobject wordt verwijderd. (Overgenomen van CommunicationObject) |
| ThrowIfDisposedOrImmutable() |
Genereert een uitzondering als het communicatieobject de State eigenschap niet is ingesteld op de Created status. (Overgenomen van CommunicationObject) |
| ThrowIfDisposedOrNotOpen() |
Genereert een uitzondering als het communicatieobject niet de Opened status heeft. (Overgenomen van CommunicationObject) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
gebeurtenis
| Name | Description |
|---|---|
| Closed |
Treedt op wanneer een communicatieobject overgaat naar de gesloten status. (Overgenomen van CommunicationObject) |
| Closing |
Treedt op wanneer een communicatieobject overgaat naar de slotstatus. (Overgenomen van CommunicationObject) |
| Faulted |
Treedt op wanneer een communicatieobject overgaat naar de foutieve status. (Overgenomen van CommunicationObject) |
| Opened |
Treedt op wanneer een communicatieobject overgaat naar de geopende status. (Overgenomen van CommunicationObject) |
| Opening |
Treedt op wanneer een communicatieobject overgaat naar de openingsstatus. (Overgenomen van CommunicationObject) |
| UnknownMessageReceived |
Treedt op wanneer een onbekend bericht wordt ontvangen. (Overgenomen van ServiceHostBase) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IDisposable.Dispose() |
Hiermee sluit u de servicehost. (Overgenomen van ServiceHostBase) |