本主题回答关于 .NET WCF SOAP 客户端的常见问题。

章节目录：

什么是绑定？

在 WCF 中，绑定描述 web 服务端点的传输、安全和消息编码。SOAP 客户端需要知道端点的绑定，以便与端点通信。SOAP 客户端可以从 WSDL 文档或 .NET WCF 客户端配置文件自动确定端点的绑定。

如何创建 .NET WCF 客户端配置文件？

Microsoft 服务模型元数据工具（svcutil.exe）可以根据服务 WSDL 文档的 URL 生成客户端配置文件。Microsoft 服务配置编辑器可用于使用图形用户界面创建和编辑 WCF 配置文件。这两个工具都是 Microsoft Windows SDK 的一部分，它包含在 Visual Studio 中，也可以从 Microsoft 下载。Web 服务的开发人员还可以为您正在测试的 web 服务提供客户端配置文件。

我必须使用 .NET WCF 客户端配置文件吗？

不是必须的。如果 web 服务的 WSDL 文档充分描述了 web 服务，那么 SOAP 客户端只需要约束到该 WSDL，而不需要使用客户端配置文件。但是，如果 web 服务使用基于证书的身份验证，则必须设置一个 .NET WCF 客户端配置文件，该文件描述安装在本地计算机上的证书的位置。WCF 绑定还定义了各种限制，包括对最大接收消息大小的限制。可以在 .NET 客户端配置文件中控制这些限制。

如何配置基于证书的身份验证？

首先，您需要使用 Windows 证书管理器安装任何客户端和服务器证书。前往 Start> Run...，输入 "certmgr.msc"，然后点击 OK 打开 Windows 证书管理器。通常，您将在受信任人库中安装服务器证书，并在个人库中安装客户端证书。接下来，必须在客户端配置文件中指定这些证书的位置。 

MSDN 网站有关于如何做到这一点的详细信息，包括配置文件示例：

• 使用证书：http://msdn.microsoft.com/en-us/library/ms731899.aspx 
• 如何：指定客户端证书值：http://msdn.microsoft.com/en-us/library/ms732391.aspx 
• 证书验证传输安全性：http://msdn.microsoft.com/en-us/library/ms731074.aspx 
• 证书客户端消息安全性：http://msdn.microsoft.com/en-us/library/ms733098.aspx 

可以使用 .NET WCF SOAP 客户端来测试旧的 .NET web 服务吗？

只适用于 WSE 3.0。.NET WCF 客户端在网络传输层面与 WSE 3.0 服务兼容。以下自定义绑定可用于使用 Secure Conversation 和 MutualCertificate11 测试 WSE 3.0 web 服务：

<binding name="SecureConversationMutualCertificate11SignEncryptConfig">
    <security authenticationMode="SecureConversation" messageProtectionOrder=
         "SignBeforeEncrypt" requireSecurityContextCancellation="false">
         <secureConversationBootstrap authenticationMode="MutualCertificate"
               securityHeaderLayout="Strict" messageProtectionOrder="SignBeforeEncrypt"
               requireSignatureConfirmation="true" />
    </security>
    <textMessageEncoding messageVersion="Soap11WSAddressingAugust2004" />
    <httpTransport />
</binding>

MSDN网站有更多细节，请参阅 http://msdn2.microsoft.com/en-us/library/ms730299.aspx。

我可以使用 .NET WCF SOAP 客户端来测试基于 Glassfish Metro/WSIT 的服务吗？

当然可以！Metro WSIT 服务与 .NET WCF 客户端（包括 SOAtest 的 SOAP 客户端工具）具有互操作性。然而，Metro 中有一个已知的 bug，其中空格和换行会导致请求消息的安全性验证失败。这个问题可以通过将扩展工具链接到 SOAP 客户端测试的请求 SOAP 信封输出来避免，该输出用于删除额外的空格：

from com.parasoft.api import * 
from java.lang import *
 
def removeAllNewLineCharacters(input, context):
    noNewLines = str(input).replace("\r", "").replace("\n", "")
    result = String(noNewLines).replaceAll(">\s*<", "><")
    Application.showMessage(result) # for debugging
    return result

常见错误