Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

IServiceBehavior-Schnittstelle

 

Veröffentlicht: Oktober 2016

Stellt einen Mechanismus bereit, um benutzerdefinierte Erweiterungen für einen gesamten Dienst zu ändern oder einzufügen, einschließlich ServiceHostBase.

Namespace:   System.ServiceModel.Description
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public interface IServiceBehavior

NameBeschreibung
System_CAPS_pubmethodAddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)

Bietet die Möglichkeit, benutzerdefinierte Daten an Bindungselemente zu übergeben, um die Vertragsimplementierung zu unterstützen.

System_CAPS_pubmethodApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

Stellt die Funktion zum Ausführen von Eigenschaftswerten zur Laufzeit oder zum Einfügen von benutzerdefinierten Erweiterungsobjekten, wie Fehlerhandler, Nachrichten- oder Parameterinterceptoren, Sicherheitserweiterungen und anderen benutzerdefinierten Erweiterungsobjekten, bereit.

System_CAPS_pubmethodValidate(ServiceDescription, ServiceHostBase)

Stellt die Funktion zur Verfügung, mit der der Diensthost und die Dienstbeschreibung geprüft werden können, um sicherzustellen, dass der Dienst erfolgreich ausgeführt wird.

Implementiert IServiceBehavior, um Aspekte der dienstweiten Ausführung auf Anwendungsebene zu ändern, zu überprüfen oder zu erweitern:

  • Verwenden Sie die ApplyDispatchBehavior-Methode zum Ändern von Eigenschaftenwerten zur Laufzeit oder zum Einfügen von benutzerdefinierten Erweiterungsobjekten, wie Fehlerhandler, Nachrichten- oder Parameterinterceptoren, Sicherheitserweiterungen und anderen benutzerdefinierten Erweiterungsobjekten.

  • Verwenden Sie die Validate-Methode zum Überprüfen der Beschreibung, bevor Windows Communication Foundation (WCF) den ausführenden Dienst erstellt, damit sichergestellt werden kann, dass sie korrekt ausgeführt werden kann.

  • Verwenden Sie die AddBindingParameters-Methode, um benutzerdefinierte Informationen zum Dienst an ein Bindungselement zu übergeben, damit der Dienst korrekt unterstützt werden kann.

IServiceBehavior-Objekte können jede dieser Methoden nutzen, jedoch ist häufig nur eine Methode von Bedeutung; in einem solchen Fall geben die nicht verwendeten Methoden keinen Wert zurück.

System_CAPS_noteHinweis

Alle IServiceBehavior-Methoden übergeben System.ServiceModel.Description.ServiceDescription-Objekte und System.ServiceModel.ServiceHostBase-Objekte als Parameter. Der ServiceDescription-Parameter dient nur zur Prüfung; wenn Sie diese Objekte ändern, ist das Ausführungsverhalten nicht definiert.

Um eine Anpassungsaufgabe auszuführen, muss das entsprechende IServiceBehavior-Objekt der Behaviors-Eigenschaft vor der Erstellung der Dienstlaufzeit hinzugefügt werden. Hierfür gibt es drei Möglichkeiten:

  • Das benutzerdefinierte Dienstverhalten wird der Behaviors-Eigenschaft programmgesteuert hinzugefügt, und zwar bevor die ICommunicationObject.Open-Methode für das System.ServiceModel.ServiceHost-Objekt aufgerufen wird.

  • Ein benutzerdefiniertes Attribut wird erstellt, das IServiceBehavior implementiert und dazu verwendet wird, zu ändernde Dienstklassen zu markieren. Wenn ein ServiceHost-Objekt erstellt wird, wird von WCF Spiegelung eingesetzt, um die Attribute für den Diensttyp zu ermitteln. Wenn ein Attribut IServiceBehavior implementiert, wird es der Verhaltensauflistung für ServiceDescription hinzugefügt.

  • Erweitern Sie die System.ServiceModel.Configuration.BehaviorExtensionElement-Klasse, um die Spezifikation des Verhaltens in einer Anwendung oder Computerkonfigurationsdatei zu unterstützen. Im Abschnitt mit Beispielen finden Sie weitere Informationen.

Beispiele für Dienstverhalten in WCF beziehen das ServiceBehaviorAttribute-Attribut und die Verhalten System.ServiceModel.Description.ServiceThrottlingBehavior, System.ServiceModel.Description.ServiceDebugBehavior und System.ServiceModel.Description.ServiceMetadataBehavior ein.

Im folgenden Codebeispiel wird veranschaulicht, wie ein in einer Anwendungskonfigurationsdatei angegebenes Dienstverhalten verwendet wird, um einen benutzerdefinierten Fehlerhandler in eine Dienstanwendung einzufügen. In diesem Beispiel fängt der Fehlerhandler alle Ausnahmen ab und wandelt sie in einen benutzerdefinierten GreetingFault-SOAP-Fehler um, der dann an den Client zurückgegeben wird.

Mit der folgenden IServiceBehavior-Implementierung werden keine Bindungsparameterobjekte hinzugefügt, wird das benutzerdefinierte System.ServiceModel.Dispatcher.IErrorHandler-Objekte jeder ChannelDispatcher.ErrorHandlers-Eigenschaft hinzugefügt und überprüft, dass jeder Vorgang des Diensts, auf den das Dienstverhalten angewendet wird, über ein System.ServiceModel.FaultContractAttribute des Typs GreetingFault verfügt.

// This behavior modifies no binding parameters.
#region IServiceBehavior Members
public void AddBindingParameters(
  ServiceDescription description, 
  ServiceHostBase serviceHostBase, 
  System.Collections.ObjectModel.Collection<ServiceEndpoint> endpoints, 
  System.ServiceModel.Channels.BindingParameterCollection parameters
)
{
  return;
}

// This behavior is an IErrorHandler implementation and 
// must be applied to each ChannelDispatcher.
public void ApplyDispatchBehavior(ServiceDescription description, ServiceHostBase serviceHostBase)
{
  Console.WriteLine("The EnforceGreetingFaultBehavior has been applied.");
  foreach(ChannelDispatcher chanDisp in serviceHostBase.ChannelDispatchers)
  {
    chanDisp.ErrorHandlers.Add(this);      
  }
}

// This behavior requires that the contract have a SOAP fault with a detail type of GreetingFault.
public void Validate(ServiceDescription description, ServiceHostBase serviceHostBase)
{
  Console.WriteLine("Validate is called.");
  foreach (ServiceEndpoint se in description.Endpoints)
  {
    // Must not examine any metadata endpoint.
    if (se.Contract.Name.Equals("IMetadataExchange")
      && se.Contract.Namespace.Equals("http://schemas.microsoft.com/2006/04/mex"))
      continue;
    foreach (OperationDescription opDesc in se.Contract.Operations)
    {
      if (opDesc.Faults.Count == 0)
        throw new InvalidOperationException(String.Format(
          "EnforceGreetingFaultBehavior requires a "  
          + "FaultContractAttribute(typeof(GreetingFault)) in each operation contract.  "
          + "The \"{0}\" operation contains no FaultContractAttribute.",
          opDesc.Name)
        );
      bool gfExists = false;
      foreach (FaultDescription fault in opDesc.Faults)
      {
        if (fault.DetailType.Equals(typeof(GreetingFault)))
        {
          gfExists = true;
          continue;
        }
      }
      if (gfExists == false)
      {
        throw new InvalidOperationException(
"EnforceGreetingFaultBehavior requires a FaultContractAttribute(typeof(GreetingFault)) in an operation contract."
        );
      }
    }
  }
}
#endregion

In diesem Beispiel implementiert die Verhaltensklasse auch System.ServiceModel.Configuration.BehaviorExtensionElement, wodurch das Dienstverhalten mithilfe einer Anwendungskonfigurationsdatei eingefügt werden kann, wie folgendes Codebeispiel zeigt.

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: