Beispiel für Ermittlungsbindungselement

In diesem Beispiel wird gezeigt, wie das Ermittlungsclient-Bindungselement verwendet wird, um einen Dienst zu ermitteln. Diese Funktion ermöglicht es Entwicklern, ihrem vorhandenen Clientkanalstapel einen Ermittlungsclientkanal hinzuzufügen. Dadurch wird das Programmiermodell sehr intuitiv. Wenn der zugeordnete Kanal geöffnet wird, wird die Adresse des Diensts mit der Ermittlung aufgelöst. Dieses Beispiel besteht aus den folgenden Projekten:

• CalculatorService: Ein ermittelbarer WCF-Dienst.

• CalculatorClient: Eine WCF-Clientanwendung, die mit dem Ermittlungsclientkanal nach dem CalculatorService sucht und diesen aufruft.

• DynamicCalculatorClient: Eine WCF-Clientanwendung, die mit einem dynamischen Endpunkt nach dem CalculatorService sucht und diesen aufruft.

Hinweis:

Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren. <Installationslaufwerk>:\WF_WCF_Samples Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4 auf, um alle Windows Communication Foundation (WCF)- und WF-Beispiele herunterzuladen. Dieses Beispiel befindet sich im folgenden Verzeichnis. <Installationslaufwerk>:\WF_WCF_Samples\WCF\Basic\Discovery\DiscoveryBindingElement

CalculatorService

Dieses Projekt enthält einen einfachen Rechnerdienst, der den ICalculatorService-Vertrag implementiert.

Die folgende APP.CONFIG-Datei wird verwendet, um ein <serviceDiscovery>-Verhalten zum Dienstverhalten und zum Ermittlungsendpunkt hinzuzufügen.

<system.serviceModel>
    <services>
      <service behaviorConfiguration="CalculatorBehavior" name="Microsoft.Samples.Discovery.CalculatorService">
        <endpoint name="udpDiscoveryEpt" kind="udpDiscoveryEndpoint" />
      </service>
    </services>
    <behaviors>
      <!--Enable discovery through configuration.-->
      <serviceBehaviors>
        <behavior name="CalculatorBehavior">
          <serviceDiscovery>
          </serviceDiscovery>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>

Dadurch werden der Dienst und seine Endpunkte ermittelbar. Der CalculatorService ist ein selbst gehosteter Dienst, der mit der NetTcpBinding-Bindung einen Endpunkt hinzufügt. Zudem wird dem Endpunkt ein EndpointDiscoveryBehavior hinzugefügt und ein Bereich angegeben, wie im folgenden Code gezeigt.

// Add a NET.TCP endpoint and add a scope to that endpoint.
ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new NetTcpBinding(), netTcpAddress);
EndpointDiscoveryBehavior netTctEndpointBehavior = new EndpointDiscoveryBehavior();
netTctEndpointBehavior.Scopes.Add(new Uri("ldap:///ou=engineering,o=exampleorg,c=us"));
netTcpEndpoint.Behaviors.Add(netTctEndpointBehavior);
serviceHost.Open();

CalculatorClient

Dieses Projekt enthält eine Clientimplementierung, mit der Meldungen an den CalculatorService gesendet werden. Das Programm erstellt mithilfe der CreateCustomBindingWithDiscoveryElement()-Methode eine benutzerdefinierte Bindung, die den Ermittlungsclientkanal verwendet.

static CustomBinding CreateCustomBindingWithDiscoveryElement()
 {
      DiscoveryClientBindingElement discoveryBindingElement = new DiscoveryClientBindingElement();
            
            // Provide the search criteria and the endpoint over which the probe is sent
            discoveryBindingElement.FindCriteria = new FindCriteria(typeof(ICalculatorService));
            discoveryBindingElement.DiscoveryEndpointProvider = new UdpDiscoveryEndpointProvider();

            CustomBinding customBinding = new CustomBinding(new NetTcpBinding());
            // Insert DiscoveryClientBindingElement at the top of the BindingElement stack.
            // An exception is thrown if this binding element is not at the top
            customBinding.Elements.Insert(0, discoveryBindingElement);

            return customBinding; }

Nachdem das DiscoveryClientBindingElement instanziiert wurde, gibt der Entwickler die Kriterien an, die bei der Suche nach einem Dienst verwendet werden sollen. In diesem Fall ist das Ermittlungssuchkriterium der ICalculatorService-Typ. Darüber hinaus gibt der Entwickler einen DiscoveryEndpointProvider an, der einen DiscoveryEndpoint zurückgibt, mit dem angegeben wird, wo nach den Diensten gesucht werden soll. Der DiscoveryEndpointProvider gibt eine neue DiscoveryEndpoint-Instanz zurück. Weitere Informationen finden Sie unter Verwenden einer benutzerdefinierten Bindung mit dem Suchclientchannel.

// Extend DiscoveryEndpointProvider class to change the default DiscoveryEndpoint
    // to the DiscoveryClientBindingElement. The Discovery ClientChannel 
    // uses this endpoint to send Probe message.
    public class UdpDiscoveryEndpointProvider : DiscoveryEndpointProvider
    {
        public override DiscoveryEndpoint GetDiscoveryEndpoint()
        {
            return new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscoveryApril2005);
        }
    }

In diesem Fall verwendet der Client den UDP-Multicastmechanismus, der im Discovery-Protokoll definiert wird, um nach Diensten im lokalen Subnetz zu suchen. Mit dem Rest der Methode wird eine benutzerdefinierte Bindung erstellt und das Discovery-Bindungselement zu Beginn des Stapels eingefügt.

Hinweis:
Das DiscoveryClientBindingElement muss zu Beginn des Bindungsstapels eingefügt werden. Für jedes BindingElement vor dem DiscoveryClientBindingElement muss sichergestellt werden, dass die erstellte Kanalfactory oder der erstellte Kanal nicht die EndpointAddress-Eigenschaft oder die Via-Eigenschaft verwendet, da die tatsächliche Adresse nur im Discovery-Clientkanal gefunden werden kann.

Als Nächstes kann der CalculatorClient instanziiert werden, indem diese benutzerdefinierte Bindung sowie eine Endpunktadresse übergeben werden.

 CalculatorServiceClient client = new CalculatorServiceClient(CreateCustomBindingWithDiscoveryElement(), DiscoveryClientBindingElement.DiscoveryEndpointAddress);

Wenn sie den Ermittlungsclientkanal verwenden, wird die konstante zuvor angegebene Endpunktadresse übergeben. Zur Laufzeit findet der Ermittlungsclientkanal den angegebenen Dienst mithilfe der Suchkriterien und stellt eine Verbindung dazu her. Damit der Dienst und der Client eine Verbindung herstellen können, müssen sie außerdem über denselben zugrunde liegenden Bindungsstapel verfügen.

So verwenden Sie dieses Beispiel

1. Öffnen Sie die Projektmappe in Visual Studio 2010.

2. Erstellen Sie die Projektmappe.

3. Führen Sie die Dienstanwendung und alle Clientanwendungen aus.

4. Beachten Sie, dass der Client den Dienst ermitteln konnte, ohne seine Adresse zu kennen.