Поделиться через


Как настраивать службы WCF для взаимодействия с клиентами веб-службы ASP.NET

Для настройки конечной точки службы Windows Communication Foundation (WCF) таким образом, чтобы она могла взаимодействовать с клиентами веб-службы ASP.NET, используйте в качестве типа привязки для конечной точки вашей службы тип System.ServiceModel.BasicHttpBinding.

В привязке можно дополнительно включить поддержку протокола HTTPS и проверку подлинности клиента на транспортном уровне. Клиенты веб-службы ASP.NET не поддерживают кодирование сообщений MTOM, поэтому для свойства System.ServiceModel.BasicHttpBinding.MessageEncoding следует сохранить значение по умолчанию, т. е. System.ServiceModel.WSMessageEncoding.Text. Клиенты веб-служб ASP.Net не поддерживают WS-Security, поэтому для System.ServiceModel.BasicHttpBinding.Security должно быть задано значение Transport.

Чтобы метаданные для службы WCF были доступны инструментам создания прокси-класса веб-службы ASP.NET (Инструмент языка описания веб-служб (Wsdl.exe), Инструмент для обнаружения веб-служб (Disco.exe) и функция "Добавить веб-ссылку" в Visual Studio), необходимо предоставить конечную точку метаданных HTTP/GET.

Добавление конечной точки WCF, совместимой с клиентами веб-службы ASP.NET, в код

  1. Создайте новый экземпляр класса BasicHttpBinding.

  2. Если требуется, включите безопасность транспортного уровня для привязки этой конечной точки службы, задав для привязки режим безопасности Transport. Дополнительные сведения см. в разделе Безопасность транспорта.

  3. Добавьте новую конечную точку приложения в узел службы, используя созданный экземпляр привязки. Дополнительные сведения о добавлении конечной точки службы в код см. в разделе Как создать конечную точку службы в коде.

  4. Включите конечную точку метаданных HTTP/GET для своей службы. Дополнительные сведения см. в разделе Как опубликовать метаданные для службы с использованием кода.

Добавление конечной точки WCF, совместимой с клиентами веб-службы ASP.NET, в файл конфигурации

  1. Создайте новую конфигурацию привязки BasicHttpBinding. Дополнительные сведения см. в разделе Как задать привязку службы в конфигурации.

  2. Если требуется, включите безопасность транспортного уровня для конфигурации привязки этой конечной точки службы, задав для привязки режим безопасности Transport. Дополнительные сведения см. в разделе Безопасность транспорта.

  3. Настройте новую конечную точку приложения для службы, используя созданную конфигурацию привязки. Дополнительные сведения о добавлении конечной точки службы в файл конфигурации см. в разделе Практическое руководство. Создание конечной точки службы в конфигурации.

  4. Включите конечную точку метаданных HTTP/GET для своей службы. Дополнительные сведения см. в разделе Практическое руководство. Публикация метаданных для службы с использованием файла конфигурации.

Пример

В следующем примере кода показано, как добавить конечную точку WCF, совместимую с клиентами веб-службы ASP.NET, в код или в файлы конфигурации.

Imports System
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 = "https://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
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 = "https://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();
    }
}
<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>

См. также

Задачи

Как создать конечную точку службы в коде
Как опубликовать метаданные для службы с использованием кода
Как задать привязку службы в конфигурации
Практическое руководство. Создание конечной точки службы в конфигурации
Практическое руководство. Публикация метаданных для службы с использованием файла конфигурации

Основные понятия

Использование метаданных

Другие ресурсы

Безопасность транспорта