Több végpont

A MultipleEndpoints-minta bemutatja, hogyan konfigurálhat több végpontot egy szolgáltatáson, és hogyan kommunikálhat az ügyfél egyes végpontjaival. Ez a minta az első lépéseken alapul. A szolgáltatáskonfiguráció úgy lett módosítva, hogy két végpontot határozzon meg, amelyek támogatják a ICalculator szerződést, de mindegyik egy másik címen, egy másik kötés használatával. Az ügyfélkonfiguráció és a kód úgy lett módosítva, hogy mindkét szolgáltatásvégponttal kommunikáljon.

Megjegyzés:

A minta telepítési eljárása és összeállítási utasításai a témakör végén találhatók.

A szolgáltatás Web.config fájl úgy lett módosítva, hogy két végpontot definiáljon, amelyek mindegyike ugyanazt ICalculator a szerződést támogatja, de különböző címeken, különböző kötéseket használva. Az első végpont az alapcímen van definiálva egy basicHttpBinding kötés használatával, ahol a biztonság nincs engedélyezve. A második végpont a {baseaddress}/secure helyen kerül meghatározásra egy wsHttpBinding kötéssel, amely alapértelmezés szerint biztonságos, és WS-Security használatával Windows-hitelesítést alkalmaz.

<service
    name="Microsoft.ServiceModel.Samples.CalculatorService"
    behaviorConfiguration="CalculatorServiceBehavior">
  <!-- This endpoint is exposed at the base address provided by host:
       http://localhost/servicemodelsamples/service.svc  -->
  <endpoint address=""
            binding="basicHttpBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculator" />
  <!-- secure endpoint exposed at {base address}/secure:
       http://localhost/servicemodelsamples/service.svc/secure -->
  <endpoint address="secure"
            binding="wsHttpBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculator" />
  ...
</service>

Mindkét végpont is konfigurálva van az ügyfélen. Ezek a végpontok neveket kapnak, hogy a hívó átadhassa a kívánt végpontnevet az ügyfél konstruktorának.

<client>
  <!-- Passing "basic" into the constructor of the CalculatorClient
       class selects this endpoint.-->
  <endpoint name="basic"
            address="http://localhost/servicemodelsamples/service.svc"
            binding="basicHttpBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculator" />
  <!-- Passing "secure" into the constructor of the CalculatorClient
       class selects this endpoint.-->
  <endpoint name="secure"
            address="http://localhost/servicemodelsamples/service.svc/secure"
            binding="wsHttpBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculator" />
</client>

Az ügyfél mindkét végpontot használja az alábbi kódban látható módon.

static void Main()
{
    // Create a client to the basic endpoint configuration.
    CalculatorClient client = new CalculatorClient("basic");
    Console.WriteLine("Communicate with basic endpoint.");
    // call operations
    DoCalculations(client);

    // Close the client and release resources.
    client.Close();

    // Create a client to the secure endpoint configuration.
    client = new CalculatorClient("secure");
    Console.WriteLine("Communicate with secure endpoint.");
    // Call operations.
    DoCalculations(client);

    // Close the client and release resources.
    client.Close();

    Console.WriteLine();
    Console.WriteLine("Press <ENTER> to terminate client.");
    Console.ReadLine();
}

Az ügyfél futtatásakor mindkét végponttal interakciók jelennek meg.

Communicate with basic endpoint.
Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714
Communicate with secure endpoint.
Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

A példa beállítása, elkészítése és futtatása

1. Győződjön meg arról, hogy elvégezte a Windows Communication Foundation-minták One-Time beállítási eljárását.

2. A megoldás C# vagy Visual Basic .NET kiadásának létrehozásához kövesse Windows Communication Foundation-mintákcímű témakör utasításait.

3. Ha a mintát egy vagy több gép közötti konfigurációban szeretné futtatni, kövesse A Windows Communication Foundation-minták futtatásacímű témakör utasításait.