大网数据广告活动
.NET 与 C# 开发

ServiceDescription 和 WSDL 引用

· 52CE 我爱测

由 WCF,导出的 WSDL 文档导入外部 XML 架构文档中使用任何 XML 架构定义。 为服务中数据类型使用的每个目标命名空间导出单独的 XML 架构文档。 同样,为服务协定使用的每个目标命名空间导出单独的 WSDL 文档。

本主题介绍与 Windows Communication Foundation (WCF) 如何映射 Web 服务描述语言 (WSDL) 文档xref:System.ServiceModel.Description.ServiceDescription实例。

ServiceDescription 如何映射到 WSDL 1.1

您可以使用 WCF 将从 WSDL 文档xref:System.ServiceModel.Description.ServiceDescription为你的服务实例。 发布元数据终结点时,将为服务自动生成 WSDL 文档。

还可以使用 xref:System.ServiceModel.Description.ServiceEndpoint 类型从 WSDL 文档导入 xref:System.ServiceModel.Description.ContractDescription 实例、xref:System.ServiceModel.Channels.Binding 实例和 WsdlImporter 实例。

由 WCF,导出的 WSDL 文档导入外部 XML 架构文档中使用任何 XML 架构定义。 为服务中数据类型使用的每个目标命名空间导出单独的 XML 架构文档。 同样,为服务协定使用的每个目标命名空间导出单独的 WSDL 文档。

ServiceDescription

xref:System.ServiceModel.Description.ServiceDescription 实例映射到 wsdl:service 元素。 xref:System.ServiceModel.Description.ServiceDescription 实例包含 xref:System.ServiceModel.Description.ServiceEndpoint 实例的集合,其中每个实例都映射到单独的 wsdl:port 元素。

属性 WSDL 映射
Name wsdl:service /@name服务的值。
Namespace 服务的 wsdl:service 定义的 targetNamespace。
Endpoints 服务的 wsdl:port 定义。

ServiceEndpoint

xref:System.ServiceModel.Description.ServiceEndpoint 实例映射到 wsdl:port 元素。 xref:System.ServiceModel.Description.ServiceEndpoint 实例包含一个地址、绑定和协定。

实现 xref:System.ServiceModel.Description.IWsdlExportExtension 接口的终结点行为可以修改它们所附加到的终结点的 wsdl:port 元素。

属性 WSDL 映射
Name wsdl:port /@name终结点的值和wsdl:binding/@name终结点绑定的值。
Address 终结点的 wsdl:port 定义的地址。 终结点的传输确定地址的格式。 例如,对于 WCF 支持传输,它可能是 SOAP 地址或终结点引用。
Binding 终结点的 wsdl:binding 定义。 与不同wsdl:binding定义,在 WCF 中的绑定不受限于任何一个协定。
Contract 终结点的 wsdl:portType 定义。
Behaviors 实现 xref:System.ServiceModel.Description.IWsdlExportExtension 接口的终结点行为可以修改终结点的 wsdl:port。

绑定

ServiceEndpoint 实例的绑定实例映射到 wsdl:binding 定义。 与不同wsdl:binding定义,必须将与特定wsdl:portType定义中,WCF 绑定是独立于任何协定。

绑定由绑定元素的集合组成。 每个元素描述终结点与客户端的通信方式的某一方面。 另外,绑定还具有一个 xref:System.ServiceModel.Channels.MessageVersion,指示终结点的 xref:System.ServiceModel.EnvelopeVersion 和 xref:System.ServiceModel.Channels.AddressingVersion。

属性 WSDL 映射
Name 在终结点的默认名称中使用,该名称是以下划线分隔追加的协定名称的绑定名称。
Namespace targetNamespace 定义的 wsdl:binding。 导入时,如果将策略附加到 WSDL 端口,则导入的绑定命名空间将映射到 targetNamespace 定义的 wsdl:port。
BindingElementCollection,由 CreateBindingElements() 方法返回 wsdl:binding 定义的各种域特定的扩展,通常是策略断言。
MessageVersion 终结点的 EnvelopeVersion 和 AddressingVersion。 如果指定 MessageVersion.None,则 WSDL 绑定不包含 SOAP 绑定,并且 WSDL 端口不包含 WS-Addressing 内容。 该设置通常用于 Plain Old XML (POX) 终结点。
BindingElements

终结点绑定的绑定元素映射到 wsdl:binding 中的各种 WSDL 扩展,如策略断言。

绑定的 xref:System.ServiceModel.Channels.TransportBindingElement 为 SOAP 绑定确定传输统一资源标识符 (URI)。

AddressingVersion

绑定上的 AddressingVersion 映射到 wsd:port 中使用的寻址版本。 WCF 支持 SOAP 1.1 和 SOAP 1.2 地址以及 Ws-addressing 08/2004 和 Ws-addressing 1.0 终结点引用。

EnvelopeVersion

绑定上的 EnvelopeVersion 映射到 wsdl:binding 中使用的 SOAP 的版本。 WCF 支持 SOAP 1.1 和 SOAP 1.2 绑定。

协定

xref:System.ServiceModel.Description.ContractDescription 实例的 ServiceEndpoint 实例映射到 wsdl:portType。 ContractDescription 实例描述给定协定的所有操作。

属性 WSDL 映射
Name wsdl:portType /@name协定的值。
Namespace wsdl:portType 定义的 targetNamespace。
SessionMode wsdl:portType /@msc:usingSession协定的值。 此属性是 WSDL 1.1 的 WCF 扩展。
Operations 协定的 wsdl:operation 定义。

操作

xref:System.ServiceModel.Description.OperationDescription实例映射到wsdl:portType / wsdl:operation。 OperationDescription 包含用于描述操作消息的 MessageDescription 实例的集合。

如下两个操作行为广泛地参与 OperationDescription 到 WSDL 文档的映射方式:DataContractSerializerOperationBehavior 和 XmlSerializerOperationBehavior。

属性 WSDL 映射
Name wsdl:portType / wsdl:operation /@name操作值。
ProtectionLevel 附加到此操作的 wsdl:binding/wsdl:operation 消息的安全策略中的保护断言。
IsInitiating wsdl:portType / wsdl:operation /@msc:isInitiating操作值。 此属性是 WSDL 1.1 的 WCF 扩展。
IsTerminating wsdl:portType / wsdl:operation /@msc:isTerminating操作值。 此属性是 WSDL 1.1 的 WCF 扩展。
Messages wsdl:portType / wsdl:operation / wsdl:input并wsdl:portType / wsdl:operation / wsdl:output操作消息。
Faults wsdl:portType / wsdl:operation / wsdl:fault操作定义。
Behaviors DataContractSerializerOperationBehavior 和 XmlSerializerOperationBehavior 处理操作绑定和操作消息。
DataContractSerializerOperationBehavior

操作的 DataContractSerializerOperationBehavior 是用于为该操作导出 WSDL 消息和绑定的 IWsdlExportExtension 实现。 XML 架构类型是使用 XsdDataContractExporter 导出的。 DataContractSerializerOperationBehavior 还为该操作确定用途、样式和要使用的架构导出程序与导入程序。

属性 WSDL 映射
DataContractFormatAttribute Style此特性的属性映射到wsdl:binding / wsdl:operation / soap:operation /@style操作值。 DataContractSerializerOperationBehavior 仅支持 WSDL 中架构类型的文字用法。
XmlSerializerOperationBehavior

操作的 XmlSerializerOperationBehavior 是用于为该操作导出 WSDL 消息和绑定的 IWsdlExportExtension 实现。 XML 架构类型是使用 XmlSchemaExporter 导出的。 XmlSerializerOperationBehavior 还为该操作确定用途、样式和要使用的架构导出程序与导入程序。

属性 WSDL 映射
XmlSerializerFormatAttribute Style此特性的属性映射到wsdl:binding / wsdl:operation / soap:operation /@style操作值。 Use此特性的属性映射到wsdl:binding / wsdl:operation / soap:operation/ */@use操作中的所有消息的值。

消息

一个MessageDescription实例映射到wsdl:message引用wsdl:portType / wsdl:operation / wsdl:input或wsdl:portType / wsdl:operation / wsdl:output操作中的消息。 MessageDescription 包含正文和标头。

属性 WSDL 映射
Action 消息的 SOAP 或 WS-Addressing 操作。 请注意,使用操作字符串“*”的操作不用 WSDL 表示。
Direction MessageDirection.Input 映射到wsdl:input。 MessageDirection.Output 映射到wsdl:output。
ProtectionLevel 附加到此消息的 wsdl:message 定义的安全策略中的保护断言。
Body 消息的消息正文。
Headers 消息的标头。
ContractDescription.Name, OperationContract.Name 在导出时,用于派生wsdl:message/@name值。
消息正文

一个MessageBodyDescription实例映射到wsdl:message / wsdl:part的消息的正文定义。 消息正文可以包装也可以裸露。

属性 WSDL 映射
WrapperName 如果样式不是 RPC,则WrapperName映射到引用的元素名wsdl:message / wsdl:part与@name设置为"parameters"。
WrapperNamespace 如果样式不是 RPC,则WrapperNamespace映射到的元素命名空间wsdl:message / wsdl:part与@name设置为"parameters"。
Parts 此消息正文的消息部分。
ReturnValue 如果存在包装元素 (文档包装样式或 RPC 样式),否则在包装元素的子元素第一个wsdl:message / wsdl:part消息中。
消息部分

一个MessagePartDescription实例映射到wsdl:message / wsdl:part和 XML 架构类型或消息部分所指向的元素。

属性 WSDL 映射
Name wsd:message / wsdl:part /@name消息部分和消息部分所指向的元素的名称值。
Namespace 消息部分所指向的元素的命名空间。
Index 索引wsdl:message / wsdl:part的消息。
ProtectionLevel 附加到此消息部分的 wsdl:message 定义的安全策略中的保护断言。 将策略参数化,使其指向特定的消息部分。
MessageType 消息部分所指向的元素的 XML 架构类型。
消息头

MessageHeaderDescription 实例是同时还映射到消息部分的 soap:header 绑定的消息部分。

错误

一个FaultDescription实例映射到wsdl:portType / wsdl:operation / wsdl:fault定义和其关联wsdl:message定义。 将 wsdl:message 添加到与其关联的 WSDL 端口类型相同的目标命名空间。 wsdl:message 有一个名为“详细信息”的消息部分,该部分指向对应于 DefaultType 实例的 FaultDescription 属性值的 XML 架构元素。

属性 WSDL 映射
Name wsdl:portType / wsdl:operation / wsdl:fault /@name错误的值。
Namespace 错误详细消息部分所指向的 XML 架构元素的命名空间。
Action 错误的 SOAP 或 WS-Addressing 操作。
ProtectionLevel 附加到此错误的 wsdl:message 定义的安全策略中的保护断言。
DetailType 详细消息部分所指向的元素的 XML 架构类型。
Name, ContractDescription.Name, OperationDescription.Name, 用于派生wsdl:message/@name错误消息的值。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。