Sdílet prostřednictvím


Postupy: Konfigurace služby WCF pro spolupráci s klienty webové služby ASP.NET

Pokud chcete nakonfigurovat koncový bod služby WCF (Windows Communication Foundation) tak, aby byl interoperabilní s klienty webové služby ASP.NET, použijte System.ServiceModel.BasicHttpBinding tento typ jako typ vazby pro koncový bod služby.

Volitelně můžete u vazby povolit podporu ověřování klientů na úrovni protokolu HTTPS a přenosu. ASP.NET klienti webové služby nepodporují kódování zpráv MTOM, takže BasicHttpBinding.MessageEncoding vlastnost by měla být ponechána jako výchozí hodnota, což je WSMessageEncoding.Text. ASP.NET klienti webové služby nepodporují zabezpečení WS-Security, takže by měla být nastavena BasicHttpBinding.Security na Transporthodnotu .

Aby byla metadata pro službu WCF dostupná pro nástroje pro generování proxy webových služeb ASP.NET (tj . nástroj web Services Description Language Tool (Wsdl.exe), nástroj pro zjišťování webových služeb (Disco.exe) a funkci Přidat webový odkaz v sadě Visual Studio), měli byste zveřejnit koncový bod metadat HTTP/GET.

Přidání koncového bodu v kódu

  1. Vytvoření nové BasicHttpBinding instance

  2. Volitelně můžete povolit zabezpečení přenosu pro tuto vazbu koncového bodu služby nastavením režimu zabezpečení vazby na Transport. Podrobnosti najdete v tématu Zabezpečení přenosu.

  3. Přidejte do hostitele služby nový koncový bod aplikace pomocí instance vazby, kterou jste právě vytvořili. Podrobnosti o tom, jak přidat koncový bod služby do kódu, najdete v tématu Postupy: Vytvoření koncového bodu služby v kódu.

  4. Povolte koncový bod metadat HTTP/GET pro vaši službu. Podrobnosti najdete v tématu Postupy: Publikování metadat pro službu pomocí kódu.

Přidání koncového bodu do konfiguračního souboru

  1. Vytvořte novou BasicHttpBinding konfiguraci vazby. Podrobnosti najdete v tématu Postupy: Určení vazby služby v konfiguraci.

  2. Volitelně můžete povolit zabezpečení přenosu pro tuto konfiguraci vazby koncového bodu služby nastavením režimu zabezpečení vazby na Transport. Podrobnosti najdete v tématu Zabezpečení přenosu.

  3. Nakonfigurujte nový koncový bod aplikace pro vaši službu pomocí konfigurace vazby, kterou jste právě vytvořili. Podrobnosti o tom, jak přidat koncový bod služby do konfiguračního souboru, najdete v tématu Postupy: Vytvoření koncového bodu služby v konfiguraci.

  4. Povolte koncový bod metadat HTTP/GET pro vaši službu. Podrobnosti najdete v tématu Postupy: Publikování metadat pro službu pomocí konfiguračního souboru.

Příklad

Následující ukázkový kód ukazuje, jak přidat koncový bod WCF, který je kompatibilní s klienty webové služby ASP.NET v kódu a alternativně v konfiguračních souborech.

using System;
using System.Collections.Generic;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Description;

[ServiceContract]
public interface IEcho
{
    [OperationContract]
    string Echo(string s);
}

public class MyService : IEcho
{
    public string Echo(string s)
    {
        return s;
    }
}

class Program
{
    static void Main(string[] args)
    {
        string baseAddress = "http://localhost:8080/wcfselfhost/";
        ServiceHost host = new ServiceHost(typeof(MyService), new Uri(baseAddress));

        // Create a BasicHttpBinding instance
        BasicHttpBinding binding = new BasicHttpBinding();

        // Add a service endpoint using the created binding
        host.AddServiceEndpoint(typeof(IEcho), binding, "echo1");

        host.Open();
        Console.WriteLine("Service listening on {0} . . .", baseAddress);
        Console.ReadLine();
        host.Close();
    }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports System.ServiceModel.Description

<ServiceContract()> _
Public Interface IEcho

    <OperationContract()> _
    Function Echo(ByVal s As String) As String

End Interface

Public Class MyService
    Implements IEcho

    Public Function Echo(ByVal s As String) As String Implements IEcho.Echo
        Return s
    End Function

End Class

Friend Class Program

    Shared Sub Main(ByVal args() As String)
        Dim baseAddress = "http://localhost:8080/wcfselfhost/"
        Dim host As New ServiceHost(GetType(MyService), _
                                    New Uri(baseAddress))

        ' Add a service endpoint using the created binding
        With host
            .AddServiceEndpoint(GetType(IEcho), _
                                New BasicHttpBinding(), _
                                "echo1")
            .Open()
            Console.WriteLine("Service listening on {0} . . .", _
                              baseAddress)
            Console.ReadLine()
            .Close()
        End With
    End Sub
End Class
<configuration>
  <system.serviceModel>
    <services>
      <service name="MyService" behaviorConfiguration="HttpGetMetadata">
        <endpoint address="echo2" contract="IEcho" binding="basicHttpBinding" />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="HttpGetMetadata">
          <serviceMetadata httpGetEnabled="true" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Viz také