ServiceHost Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.dll

Udostępnia hosta dla usług.

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

public class ServiceHost : System.ServiceModel.ServiceHostBase

type ServiceHost = class
    inherit ServiceHostBase

Public Class ServiceHost
Inherits ServiceHostBase

Dziedziczenie

Object

CommunicationObject

ServiceHostBase

ServiceHost

Pochodne

System.ServiceModel.Security.WSTrustServiceHost

System.ServiceModel.Web.WebServiceHost

Przykłady

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

Uwagi

Implementuje hosta używanego przez model programowania modelu usług Windows Communication Foundation (WCF).

Użyj klasy ServiceHost, aby skonfigurować i uwidocznić usługę do użycia przez aplikacje klienckie, gdy nie używasz Internet Information Services (IIS) lub usług aktywacji Windows (WAS), aby uwidocznić usługę. Zarówno usługi IIS, jak i WAS współdziałają z obiektem ServiceHost w Twoim imieniu.

Aby uwidocznić usługę do użycia przez osoby wywołujące, program WCF wymaga pełnego opisu usługi (reprezentowanego przez klasę ServiceDescription ). Klasa ServiceHost tworzy element ServiceDescription na podstawie typu usługi i informacji o konfiguracji, a następnie używa tego opisu do tworzenia ChannelDispatcher obiektów dla każdego punktu końcowego w opisie.

ServiceHost Użyj obiektu, aby załadować usługę, skonfigurować punkty końcowe, zastosować ustawienia zabezpieczeń i uruchomić odbiorniki do obsługi żądań przychodzących.

Konstruktory

Nazwa	Opis
ServiceHost()	Inicjuje nowe wystąpienie klasy ServiceHost.
ServiceHost(Object, Uri[])	Inicjuje nowe wystąpienie ServiceHost klasy z określonym wystąpieniem usługi i jego adresami podstawowymi.
ServiceHost(Type, Uri[])	Inicjuje nowe wystąpienie ServiceHost klasy z określonym typem usługi i określonymi adresami podstawowymi.

Właściwości

Nazwa	Opis
Authentication	Pobiera zachowanie uwierzytelniania usługi. (Odziedziczone po ServiceHostBase)
Authorization	Pobiera zachowanie autoryzacji dla usługi hostowanej. (Odziedziczone po ServiceHostBase)
BaseAddresses	Pobiera adresy podstawowe używane przez hostowaną usługę. (Odziedziczone po ServiceHostBase)
ChannelDispatchers	Pobiera kolekcję dyspozytorów kanałów używanych przez hosta usługi. (Odziedziczone po ServiceHostBase)
CloseTimeout	Pobiera lub ustawia interwał czasu dozwolony dla hosta usługi do zamknięcia. (Odziedziczone po ServiceHostBase)
Credentials	Pobiera poświadczenia dla hostowanej usługi. (Odziedziczone po ServiceHostBase)
DefaultCloseTimeout	Pobiera domyślny interwał czasu dozwolony dla hosta usługi do zamknięcia. (Odziedziczone po ServiceHostBase)
DefaultOpenTimeout	Pobiera domyślny interwał czasu dozwolony dla hosta usługi do otwarcia. (Odziedziczone po ServiceHostBase)
Description	Pobiera opis hostowanej usługi. (Odziedziczone po ServiceHostBase)
Extensions	Pobiera rozszerzenia dla bieżącego określonego hosta usługi. (Odziedziczone po ServiceHostBase)
ImplementedContracts	Pobiera kontrakty zaimplementowane przez usługę hostowaną. (Odziedziczone po ServiceHostBase)
IsDisposed	Pobiera wartość wskazującą, czy obiekt komunikacji został usunięty. (Odziedziczone po CommunicationObject)
ManualFlowControlLimit	Pobiera lub ustawia limit sterowania przepływem dla komunikatów odebranych przez usługę hostowaną. (Odziedziczone po ServiceHostBase)
OpenTimeout	Pobiera lub ustawia interwał czasu dozwolonego dla hosta usługi do otwarcia. (Odziedziczone po ServiceHostBase)
SingletonInstance	Pobiera pojedyncze wystąpienie hostowanej usługi.
State	Pobiera wartość wskazującą bieżący stan obiektu komunikacji. (Odziedziczone po CommunicationObject)
ThisLock	Pobiera wzajemnie wykluczającą się blokadę, która chroni wystąpienie klasy podczas przejścia stanu. (Odziedziczone po CommunicationObject)

Metody

Nazwa	Opis
Abort()	Powoduje natychmiastowe przejście obiektu komunikacyjnego z bieżącego stanu do stanu zamknięcia. (Odziedziczone po CommunicationObject)
AddBaseAddress(Uri)	Dodaje adres podstawowy do hosta usługi. (Odziedziczone po ServiceHostBase)
AddDefaultEndpoints()	Dodaje punkty końcowe usługi dla wszystkich adresów bazowych w każdym kontrakcie znajdującym się na hoście usługi z domyślnym powiązaniem. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)	Dodaje określony punkt końcowy usługi do hostowanej usługi. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem, adresem punktu końcowego i identyfikatorem URI zawierającym adres, pod którym nasłuchuje. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(String, Binding, String)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i adresem punktu końcowego. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorami URI, które zawierają punkt końcowy i adresy nasłuchiwania. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorem URI zawierającym adres punktu końcowego. (Odziedziczone po ServiceHostBase)
AddServiceEndpoint(Type, Binding, String, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem, adresem punktu końcowego i identyfikatorem URI, na którym nasłuchuje usługa.
AddServiceEndpoint(Type, Binding, String)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i adresem punktu końcowego.
AddServiceEndpoint(Type, Binding, Uri, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem, identyfikatorem URI zawierającym adres punktu końcowego i identyfikatorem URI, na którym nasłuchuje usługa.
AddServiceEndpoint(Type, Binding, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorem URI zawierającym adres punktu końcowego.
ApplyConfiguration()	Ładuje opis usługi z pliku konfiguracji i stosuje go do tworzonego środowiska uruchomieniowego.
BeginClose(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną w celu zamknięcia obiektu komunikacji. (Odziedziczone po CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby zamknąć obiekt komunikacji z określonym limitem czasu. (Odziedziczone po CommunicationObject)
BeginOpen(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną w celu otwarcia obiektu komunikacji. (Odziedziczone po CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt komunikacji w określonym przedziale czasu. (Odziedziczone po CommunicationObject)
Close()	Powoduje przejście obiektu komunikacyjnego z bieżącego stanu do stanu zamkniętego. (Odziedziczone po CommunicationObject)
Close(TimeSpan)	Powoduje przejście obiektu komunikacyjnego z bieżącego stanu do stanu zamkniętego w określonym przedziale czasu. (Odziedziczone po CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)	Tworzy opis hostowanej usługi.
EndClose(IAsyncResult)	Wykonuje operację asynchroniczną w celu zamknięcia obiektu komunikacyjnego. (Odziedziczone po CommunicationObject)
EndOpen(IAsyncResult)	Wykonuje operację asynchroniczną, aby otworzyć obiekt komunikacji. (Odziedziczone po CommunicationObject)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
Fault()	Powoduje przejście obiektu komunikacyjnego z bieżącego stanu na stan błędu. (Odziedziczone po CommunicationObject)
GetCommunicationObjectType()	Pobiera typ obiektu komunikacji. (Odziedziczone po CommunicationObject)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IncrementManualFlowControlLimit(Int32)	Zwiększa limit szybkości przepływów komunikatów do hostowanej usługi przez określony przyrost. (Odziedziczone po ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)	Inicjuje opis usługi hostowanej na podstawie jego wystąpienia i określonych adresów bazowych.
InitializeDescription(Type, UriSchemeKeyedCollection)	Inicjuje opis usługi hostowanej na podstawie typu i określonych adresów bazowych.
InitializeDescription(UriSchemeKeyedCollection)	Tworzy i inicjuje hosta usługi przy użyciu kontraktu i opisów usług. (Odziedziczone po ServiceHostBase)
InitializeRuntime()	Inicjuje środowisko uruchomieniowe hosta usługi. (Odziedziczone po ServiceHostBase)
LoadConfigurationSection(ServiceElement)	Ładuje element usługi z pliku konfiguracji hostowanej usługi. (Odziedziczone po ServiceHostBase)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnAbort()	Przerywa usługę. (Odziedziczone po ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną wywoływaną na zamknięciu hosta usługi. (Odziedziczone po ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną wywoływaną podczas otwierania hosta usługi. (Odziedziczone po ServiceHostBase)
OnClose(TimeSpan)	Zamyka hostowaną usługę, w tym ich dyspozytorów kanałów i skojarzonych kontekstów wystąpień i odbiorników. (Odziedziczone po ServiceHostBase)
OnClosed()	Usuwanie jednorazowych usług hostowanych po zamknięciu hosta usługi.
OnClosing()	Wywoływane podczas przejścia obiektu komunikacyjnego do stanu zamknięcia. (Odziedziczone po CommunicationObject)
OnEndClose(IAsyncResult)	Kończy operację asynchroniczną wywołaną podczas zamykania hosta usługi. (Odziedziczone po ServiceHostBase)
OnEndOpen(IAsyncResult)	Kończy operację asynchroniczną wywołaną podczas otwierania hosta usługi. (Odziedziczone po ServiceHostBase)
OnFaulted()	Wstawia przetwarzanie na obiekcie komunikacji po przejściu do stanu błędu z powodu wywołania operacji błędu synchronicznego. (Odziedziczone po CommunicationObject)
OnOpen(TimeSpan)	Otwiera dyspozytorów kanałów. (Odziedziczone po ServiceHostBase)
OnOpened()	Pobiera poświadczenia usługi, uwierzytelnianie usługi i zachowanie autoryzacji dla hostowanej usługi. (Odziedziczone po ServiceHostBase)
OnOpening()	Wywoływane podczas przejścia obiektu komunikacyjnego do stanu otwierania. (Odziedziczone po CommunicationObject)
Open()	Powoduje przejście obiektu komunikacyjnego ze stanu utworzonego na otwarty stan. (Odziedziczone po CommunicationObject)
Open(TimeSpan)	Powoduje przejście obiektu komunikacyjnego z utworzonego stanu do otwartego stanu w określonym przedziale czasu. (Odziedziczone po CommunicationObject)
ReleasePerformanceCounters()	Zwalnia liczniki wydajności dyspozytora usług i dyspozytora kanału dla hostowanej usługi. (Odziedziczone po ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)	Ustawia adres punktu końcowego określonego punktu końcowego na określony adres. (Odziedziczone po ServiceHostBase)
ThrowIfDisposed()	Zgłasza wyjątek, jeśli obiekt komunikacji jest usuwany. (Odziedziczone po CommunicationObject)
ThrowIfDisposedOrImmutable()	Zgłasza wyjątek, jeśli obiekt komunikacji, który State nie jest ustawiony na Created stan . (Odziedziczone po CommunicationObject)
ThrowIfDisposedOrNotOpen()	Zgłasza wyjątek, jeśli obiekt komunikacji nie znajduje się w Opened stanie. (Odziedziczone po CommunicationObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwa	Opis
Closed	Występuje, gdy obiekt komunikacji przechodzi do stanu zamkniętego. (Odziedziczone po CommunicationObject)
Closing	Występuje, gdy obiekt komunikacji przechodzi do stanu zamknięcia. (Odziedziczone po CommunicationObject)
Faulted	Występuje, gdy obiekt komunikacji przechodzi do stanu błędu. (Odziedziczone po CommunicationObject)
Opened	Występuje, gdy obiekt komunikacji przechodzi do otwartego stanu. (Odziedziczone po CommunicationObject)
Opening	Występuje, gdy obiekt komunikacji przechodzi do stanu otwierania. (Odziedziczone po CommunicationObject)
UnknownMessageReceived	Występuje po odebraniu nieznanego komunikatu. (Odziedziczone po ServiceHostBase)

Jawne implementacje interfejsu

Nazwa	Opis
IDisposable.Dispose()	Zamyka hosta usługi. (Odziedziczone po ServiceHostBase)