Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch
Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

IServiceBehavior-Schnittstelle

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

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

  NameBeschreibung
Öffentliche MethodeAddBindingParametersBietet die Möglichkeit, benutzerdefinierte Daten an Bindungselemente zu übergeben, um die Vertragsimplementierung zu unterstützen.
Öffentliche MethodeApplyDispatchBehaviorStellt die Funktion zum Ändern von Eigenschaftenwerten zur Laufzeit oder zum Einfügen von benutzerdefinierten Erweiterungsobjekten, wie Fehlerhandler, Nachrichten- oder Parameterinterceptoren, Sicherheitserweiterungen und anderen benutzerdefinierten Erweiterungsobjekten, bereit.
Öffentliche MethodeValidateStellt 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.
Zum Seitenanfang

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

HinweisHinweis

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


<configuration>
  <system.serviceModel>
    <services>
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metaAndErrors">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService"/>
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
         />
        <endpoint
          address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"
         />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="metaAndErrors">
          <serviceDebug includeExceptionDetailInFaults="true"/>
          <serviceMetadata httpGetEnabled="true"/>
          <enforceGreetingFaults />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <extensions>
      <behaviorExtensions>
        <add 
          name="enforceGreetingFaults" 
          type="Microsoft.WCF.Documentation.EnforceGreetingFaultBehavior, HostApplication, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"
        />
      </behaviorExtensions>
    </extensions>
  </system.serviceModel>
</configuration>



<configuration>
  <system.serviceModel>
    <services>
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metaAndErrors">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService"/>
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
         />
        <endpoint
          address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"
         />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="metaAndErrors">
          <serviceDebug includeExceptionDetailInFaults="true"/>
          <serviceMetadata httpGetEnabled="true"/>
          <enforceGreetingFaults />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <extensions>
      <behaviorExtensions>
        <add 
          name="enforceGreetingFaults" 
          type="Microsoft.WCF.Documentation.EnforceGreetingFaultBehavior, HostApplication, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"
        />
      </behaviorExtensions>
    </extensions>
  </system.serviceModel>
</configuration>


.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.
Anzeigen: