第十四章 创建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 参数。