要将 Windows Communication Foundation (WCF) 服务终结点配置为可与 ASP.NET Web 服务客户端进行互操作,请使用 System.ServiceModel.BasicHttpBinding 类型作为服务终结点的绑定类型。
你可以根据需要在该绑定上启用对 HTTPS 和传输级客户端身份验证的支持。 ASP.NET Web 服务客户端不支持 MTOM 消息编码,所以应该使 BasicHttpBinding.MessageEncoding 属性保留其默认值,即 WSMessageEncoding.Text。 ASP.NET Web 服务客户端不支持 WS-Security,所以应将 BasicHttpBinding.Security 设置为 Transport。
要使 WCF 服务的元数据可供 ASP.NET Web 服务代理生成工具(即 Web 服务描述语言工具 (Wsdl.exe))、Web 服务发现工具 (Disco.exe))以及 Visual Studio 中的“添加 Web 引用”功能)使用,应公开一个 HTTP/GET 元数据终结点。
在代码中添加终结点
创建一个新的 BasicHttpBinding 实例。
(可选)将此服务终结点绑定的安全模式设置为 Transport,从而为此绑定启用传输安全。 有关详细信息,请参阅传输安全性。
使用刚创建的绑定实例,向服务主机添加一个新的应用程序终结点。 有关如何在代码中添加服务终结点的详细信息,请参阅如何:在代码中创建服务终结点。
为服务启用一个 HTTP/GET 元数据终结点。 有关详细信息,请参阅如何:使用代码发布服务的元数据。
在配置文件中添加终结点
创建一个新的 BasicHttpBinding 绑定配置。 有关详细信息,请参阅如何:在配置中指定服务绑定。
(可选)将此服务终结点绑定的安全模式设置为 Transport,从而为此绑定配置启用传输安全。 有关详细信息,请参阅传输安全性。
使用刚创建的绑定配置,为服务配置一个新的应用程序终结点。 有关如何在配置文件中添加服务终结点的详细信息,请参阅如何:在配置中创建服务终结点。
为服务启用一个 HTTP/GET 元数据终结点。 有关详细信息,请参阅如何:使用配置文件发布服务的元数据。
示例
下面的示例代码演示如何在代码(或配置文件)中添加与 ASP.NET Web 服务客户端兼容的 WCF 终结点。
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 {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>