第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项
文章目录
- 第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项
- `XML` 命名空间的 `SOAP` 向导选项
- 添加 `NAMESPACE` 类参数
- 对文档样式 `Web` 方法使用未包装的消息格式
- 不创建数组属性
- 为可为 `null` 的元素生成 `XMLNIL` 属性参数
- 为可为 `nillable` 元素生成 `XMLNILNOOBJECT` 属性参数
- 将 `XMLSEQUENCE` 参数设置为 `0`
- 生成设置为 `1` 的 `XMLIGNORENULL` 参数
- 使用二进制流
- 指定 `SECURITYIN` 类参数
第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项
XML 命名空间的 SOAP 向导选项
SOAP 向导的第 3 步屏幕包括以下选项，使能够配置从 WSDL 生成的类包：
添加 NAMESPACE 类参数
指示生成的类型类是否将包含等于 Web 服务的命名空间的 NAMESPACE 类参数集。
- 如果
WSDL显式指示给定类型所属的命名空间，则“添加命名空间类参数”会被选中并呈灰色显示。在这种情况下，生成的类型类包括等于该命名空间的NAMESPACE类参数集。 - 如果
WSDL没有指明给定类型的命名空间，可以选择或清除添加NAMESPACE类参数。
对文档样式 Web 方法使用未包装的消息格式
指示是否对生成的 Web 客户端中的方法使用未包装的消息格式。此选项仅影响 SoapBindingStyle 等于“document”的方法。
如果 WSDL 满足以下任一陈述，请选中此复选框：
<message>元素包含多个部分。- 响应消息使用的类型属于多个命名空间。
或者，向导会失败并显示如下错误消息：
ERROR #6425: Element 'wsdl:binding:operation:msg:input' - message 'AddSoapOut'
Message Style must be used for document style message with 2 or more parts.
不创建数组属性
指示向导是否生成数组属性。
为可为 null 的元素生成 XMLNIL 属性参数
指示向导是否为生成的类中的适用属性指定 XMLNIL 属性参数。
此选项适用于与用 nillable="true" 指定的 XML 元素相对应的每个属性。如果选择此选项，向导会将 XMLNIL=1 添加到属性定义中。否则不添加该参数。
为可为 nillable 元素生成 XMLNILNOOBJECT 属性参数
指示向导是否为生成的类中的适用属性指定 XMLNILNOOBJECT 属性参数。
此选项适用于与使用 nillable="true" 指定的 XML 元素相对应的每个属性。如果选择此选项，向导会将 XMLNILNOOBJECT=1 添加到属性定义中。否则，向导不会添加此参数。
将 XMLSEQUENCE 参数设置为 0
指示向导是否将生成的类中的 XMLSEQUENCE 类参数设置为 0。
默认情况下，向导在生成的类中将此参数设置为 1，这可确保这些类遵循 WSDL 架构中给定的元素顺序。当架构在给定父级中具有多个同名元素时，此值非常有用。
生成设置为 1 的 XMLIGNORENULL 参数
指示向导是否在生成的类中指定 XMLIGNORENULL 类参数。
如果选择此选项，向导会将 XMLIGNORENULL=1 添加到类定义中，包括生成的 Web 客户端（或 Web 服务）。否则不添加该参数。
使用二进制流
指示向导是否为每个 xsd:base64Binary 类型的元素生成一个 %Stream.GlobalBinary 类型的属性。
如果选择此选项，则生成的属性的类型为 %Stream.GlobalBinary。或者，属性的类型为 %xsd.base64Binary。
该向导会忽略 xsd:base64Binary 类型的任何属性。
指定 SECURITYIN 类参数
指定生成的客户端类中 SECURITYIN 类参数的值。
如果使用 Web 服务安全性，请使用 REQUIRE 或 ALLOW，具体取决于希望客户端需要这些元素还是只是验证它们。否则，IGNORE 或 IGNOREALL 通常是合适的。
如果关联（和编译的）配置类中存在安全策略，则忽略 SECURITYIN 参数。