Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ServiceHost-Klasse

.NET Framework 4

Stellt einen Host für Dienste bereit.

System.Object
  System.ServiceModel.Channels.CommunicationObject
    System.ServiceModel.ServiceHostBase
      System.ServiceModel.ServiceHost
        System.ServiceModel.Web.WebServiceHost

Namespace:  System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)
C#
C++
F#
VB
Kopieren 
public class ServiceHost : ServiceHostBase

Der ServiceHost-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Geschützte Methode ServiceHost() Initialisiert eine neue Instanz der ServiceHost-Klasse.
Öffentliche Methode ServiceHost(Object, Uri[]) Initialisiert eine neue Instanz der ServiceHost-Klasse mit der angegebenen Dienstinstanz und ihrer Basisadresse.
Öffentliche Methode ServiceHost(Type, Uri[]) Initialisiert eine neue Instanz der ServiceHost-Klasse mit dem angegebenen Diensttyp und seiner Basisadresse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Authentication Ruft das Dienstauthentifizierungsverhalten ab. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft Authorization Ruft das Autorisierungsverhalten für den gehosteten Dienst ab. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft BaseAddresses Ruft die vom gehosteten Dienst verwendeten Basisadressen ab. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft ChannelDispatchers Ruft die Auflistung der vom Diensthost verwendeten Kanalverteiler ab. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft CloseTimeout Ruft das Zeitintervall ab oder legt das Zeitintervall fest, das für das Schließen des Diensthosts zulässig ist. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft Credentials Ruft die Anmeldeinformationen für den gehosteten Dienst ab. (Von ServiceHostBase geerbt.)
Geschützte Eigenschaft DefaultCloseTimeout Ruft das standardmäßige Zeitintervall ab, das für das Schließen des Diensthosts zulässig ist. (Von ServiceHostBase geerbt.)
Geschützte Eigenschaft DefaultOpenTimeout Ruft das standardmäßige Zeitintervall ab, das für das Öffnen des Diensthosts zulässig ist. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft Description Ruft die Beschreibung des gehosteten Diensts ab. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft Extensions Ruft die Erweiterungen für den aktuellen angegebenen Diensthost ab. (Von ServiceHostBase geerbt.)
Geschützte Eigenschaft ImplementedContracts Ruft die durch den gehosteten Dienst implementierten Verträge ab. (Von ServiceHostBase geerbt.)
Geschützte Eigenschaft IsDisposed Ruft einen Wert ab, mit dem angegeben wird, ob das Kommunikationsobjekt verworfen wurde. (Von CommunicationObject geerbt.)
Öffentliche Eigenschaft ManualFlowControlLimit Ruft die Datenflusskontrollengrenze für durch den gehosteten Dienst empfangenen Nachrichten ab oder legt sie fest. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft OpenTimeout Ruft das Zeitintervall ab oder legt das Zeitintervall fest, das für das Öffnen des Diensthosts zulässig ist. (Von ServiceHostBase geerbt.)
Öffentliche Eigenschaft SingletonInstance Ruft die Singletoninstanz des gehosteten Diensts ab.
Öffentliche Eigenschaft State Ruft einen Wert ab, der den aktuellen Zustand des Kommunikationsobjekts angibt. (Von CommunicationObject geerbt.)
Geschützte Eigenschaft ThisLock Ruft die gegenseitig exklusive Sperre ab, die die Klasseninstanz während eines Zustandsübergangs schützt. (Von CommunicationObject geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Abort Bewirkt, dass ein Kommunikationsobjekt unmittelbar vom aktuellen Zustand in den Schließzustand übergeht. (Von CommunicationObject geerbt.)
Geschützte Methode AddBaseAddress Fügt dem Diensthost eine Basisadresse hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddDefaultEndpoints Fügt Dienstendpunkte für alle Basisadressen in jedem Vertrag im Diensthost mit der Standardbindung hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(ServiceEndpoint) Fügt den angegebenen Dienstendpunkt dem gehosteten Dienst hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(String, Binding, String) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einer Endpunktadresse hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(String, Binding, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einem URI mit der Endpunktadresse hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(Type, Binding, String) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einer Endpunktadresse hinzu.
Öffentliche Methode AddServiceEndpoint(Type, Binding, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einem URI mit der Endpunktadresse hinzu.
Öffentliche Methode AddServiceEndpoint(String, Binding, String, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung, einer Endpunktadresse und einem URI hinzu, der die Adresse enthält, die er überwacht. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(String, Binding, Uri, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit dem angegebenen Vertrag, einer Bindung und URIs mit den Endpunkt- und Überwachungsadressen hinzu. (Von ServiceHostBase geerbt.)
Öffentliche Methode AddServiceEndpoint(Type, Binding, String, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung, einer Endpunktadresse und einem URI, den der Dienst überwacht, hinzu.
Öffentliche Methode AddServiceEndpoint(Type, Binding, Uri, Uri) Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung, einem URI mit der Endpunktadresse und einem URI, den der Dienst überwacht, hinzu.
Geschützte Methode ApplyConfiguration Lädt die Dienstbeschreibungsinformationen aus der Konfigurationsdatei und wendet sie auf die Laufzeit an, die erstellt wird. (Von ServiceHostBase geerbt.)
Öffentliche Methode BeginClose(AsyncCallback, Object) Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Von CommunicationObject geerbt.)
Öffentliche Methode BeginClose(TimeSpan, AsyncCallback, Object) Startet einen asynchronen Vorgang, um mit einem festgelegten Timeout ein Kommunikationsobjekt zu schließen. (Von CommunicationObject geerbt.)
Öffentliche Methode BeginOpen(AsyncCallback, Object) Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Von CommunicationObject geerbt.)
Öffentliche Methode BeginOpen(TimeSpan, AsyncCallback, Object) Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen. (Von CommunicationObject geerbt.)
Öffentliche Methode Close() Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den geschlossenen Zustand übergeht. (Von CommunicationObject geerbt.)
Öffentliche Methode Close(TimeSpan) Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom aktuellen Zustand in den geschlossenen Zustand. (Von CommunicationObject geerbt.)
Geschützte Methode CreateDescription Erstellt eine Beschreibung des gehosteten Diensts. (Überschreibt ServiceHostBase.CreateDescription(IDictionary<String, ContractDescription>).)
Öffentliche Methode EndClose Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu schließen. (Von CommunicationObject geerbt.)
Öffentliche Methode EndOpen Beendet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. (Von CommunicationObject geerbt.)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Fault Bewirkt, dass ein Kommunikationsobjekt vom aktuellen Zustand in den Fehlerzustand übergeht. (Von CommunicationObject geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Geschützte Methode GetCommunicationObjectType Ruft den Typ des Kommunikationsobjekts ab. (Von CommunicationObject geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode IncrementManualFlowControlLimit Erhöht die Grenze der Datenflussrate der Nachrichten an den gehosteten Dienst um eine angegebene Schrittweite. (Von ServiceHostBase geerbt.)
Geschützte Methode InitializeDescription(UriSchemeKeyedCollection) Erstellt und initialisiert den Diensthost mit dem Vertrag und den Dienstbeschreibungen. (Von ServiceHostBase geerbt.)
Geschützte Methode InitializeDescription(Object, UriSchemeKeyedCollection) Initialisiert eine Beschreibung des auf der Grundlage seiner Instanz und der angegebenen Basisadressen gehosteten Dienst.
Geschützte Methode InitializeDescription(Type, UriSchemeKeyedCollection) Initialisiert eine Beschreibung des auf der Grundlage seines Typs und der angegebenen Basisadressen gehosteten Dienst.
Geschützte Methode InitializeRuntime Initialisiert die Laufzeit für den Diensthost. (Von ServiceHostBase geerbt.)
Geschützte Methode LoadConfigurationSection Lädt das Dienstelement aus der Konfigurationsdatei des gehosteten Diensts. (Von ServiceHostBase geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnAbort Bricht den Dienst ab. (Von ServiceHostBase geerbt.)
Geschützte Methode OnBeginClose Startet einen durch das Schließen des Diensthosts aufgerufenen asynchronen Vorgang. (Von ServiceHostBase geerbt.)
Geschützte Methode OnBeginOpen Startet einen durch das Öffnen des Diensthosts aufgerufenen asynchronen Vorgang. (Von ServiceHostBase geerbt.)
Geschützte Methode OnClose Schließt den gehosteten Dienst, einschließlich Kanalverteiler und zugeordneter Instanzkontexte und Listener. (Von ServiceHostBase geerbt.)
Geschützte Methode OnClosed Verwirft gehostete Dienste, wenn der Diensthost geschlossen wird. (Überschreibt ServiceHostBase.OnClosed().)
Geschützte Methode OnClosing Wird während des Übergangs eines Kommunikationsobjekts in den Schließzustand aufgerufen. (Von CommunicationObject geerbt.)
Geschützte Methode OnEndClose Schließt einen durch das Schließen des Diensthosts aufgerufenen asynchronen Vorgang ab. (Von ServiceHostBase geerbt.)
Geschützte Methode OnEndOpen Schließt einen durch das Öffnen des Diensthosts aufgerufenen asynchronen Vorgang ab. (Von ServiceHostBase geerbt.)
Geschützte Methode OnFaulted Fügt Verarbeitung auf einem Kommunikationsobjekt ein, nachdem aufgrund des Aufrufs eines synchronen Fehlervorgangs der Übergang zum Fehlerzustand stattgefunden hat. (Von CommunicationObject geerbt.)
Geschützte Methode OnOpen Öffnet die Kanalverteiler. (Von ServiceHostBase geerbt.)
Geschützte Methode OnOpened Ruft die Dienstanmeldeinformationen, die Dienstauthentifizierung und das Autorisierungsverhalten für den gehosteten Dienst ab. (Von ServiceHostBase geerbt.)
Geschützte Methode OnOpening Wird während des Übergangs eines Kommunikationsobjekts in den Öffnungszustand aufgerufen. (Von CommunicationObject geerbt.)
Öffentliche Methode Open() Bewirkt den Übergang eines Kommunikationsobjekts aus dem Erstellt-Zustand in den Geöffnet-Zustand. (Von CommunicationObject geerbt.)
Öffentliche Methode Open(TimeSpan) Bewirkt den Übergang eines Kommunikationsobjekts innerhalb eines angegebenen Zeitraums vom Erstellt-Zustand in den Geöffnet-Zustand. (Von CommunicationObject geerbt.)
Geschützte Methode ReleasePerformanceCounters Gibt die Leistungsindikatoren für den Dienst und die Kanalverteiler für den gehosteten Dienst frei. (Von ServiceHostBase geerbt.)
Öffentliche Methode SetEndpointAddress Legt die Endpunktadresse des angegebenen Endpunkts auf die angegebene Adresse fest. (Von ServiceHostBase geerbt.)
Geschützte Methode ThrowIfDisposed Löst eine Ausnahme aus, wenn das Kommunikationsobjekt verworfen wird. (Von CommunicationObject geerbt.)
Geschützte Methode ThrowIfDisposedOrImmutable Löst eine Ausnahme aus, wenn das Kommunikationsobjekt der State-Eigenschaft nicht auf den Created-Zustand festgelegt wurde. (Von CommunicationObject geerbt.)
Geschützte Methode ThrowIfDisposedOrNotOpen Löst eine Ausnahme aus, wenn sich das Kommunikationsobjekt nicht im Opened-Zustand befindet. (Von CommunicationObject geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Closed Tritt ein, sobald ein Kommunikationsobjekt in den geschlossenen Zustand übergeht. (Von CommunicationObject geerbt.)
Öffentliches Ereignis Closing Tritt ein, sobald ein Kommunikationsobjekt in den Schließzustand übergeht. (Von CommunicationObject geerbt.)
Öffentliches Ereignis Faulted Tritt ein, sobald ein Kommunikationsobjekt in den Fehlerzustand übergeht. (Von CommunicationObject geerbt.)
Öffentliches Ereignis Opened Tritt ein, sobald ein Kommunikationsobjekt in den Geöffnet-Zustand übergeht. (Von CommunicationObject geerbt.)
Öffentliches Ereignis Opening Tritt ein, sobald ein Kommunikationsobjekt in den Öffnungszustand übergeht. (Von CommunicationObject geerbt.)
Öffentliches Ereignis UnknownMessageReceived Tritt ein, wenn eine unbekannte Nachricht empfangen wird. (Von ServiceHostBase geerbt.)
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Methode IDisposable.Dispose Schließt den Diensthost. (Von ServiceHostBase geerbt.)
Zum Seitenanfang

Implementiert den Host, der vom Progammiermodell für das -Dienstmodell verwendet wird.

Verwenden Sie die ServiceHost-Klasse, um einen Dienst für die Verwendung durch Clientanwendungen zu konfigurieren und verfügbar zu machen, sofern Sie hierfür nicht Internetinformationsdienste (IIS) oder Windows Activation Services (WAS) verwenden. Sowohl IIS als auch WAS interagieren an Ihrer Stelle mit einem ServiceHost-Objekt.

Um einen Dienst zur Verwendung durch Aufrufer verfügbar zu machen, erfordert eine umfassende Dienstbeschreibung (dargestellt durch die ServiceDescription-Klasse). Die ServiceHost-Klasse erstellt anhand des Diensttyps und der Konfigurationsinformationen eine ServiceDescription und verwendet diese Beschreibung zum Erstellen von ChannelDispatcher-Objekten für jeden Endpunkt in der Beschreibung.

Verwenden Sie ein ServiceHost-Objekt, um einen Dienst zu laden, Endpunkte zu konfigurieren, Sicherheitseinstellungen anzuwenden und Listener zur Behandlung eingehender Anforderungen zu starten.

C#
VB
Kopieren 

// 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();
    }
  }
}

.NET Framework

Unterstützt in: 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ