SoapOption SoapOption SoapOption SoapOption Enum

Определение

Задает параметры конфигурации SOAP для использования с классом SoapTypeAttribute.Specifies the SOAP configuration options for use with the SoapTypeAttribute class.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

public enum class SoapOption
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum SoapOption
type SoapOption = 
Public Enum SoapOption
Наследование
Атрибуты

Поля

AlwaysIncludeTypes AlwaysIncludeTypes AlwaysIncludeTypes AlwaysIncludeTypes 1

Указывает, что тип всегда будет включаться в элементы SOAP.Indicates that type will always be included on SOAP elements. Этот параметр полезен при выполнении взаимодействия SOAP с реализациями SOAP, которым необходимы типы для всех элементов.This option is useful when performing SOAP interop with SOAP implementations that require types on all elements.

EmbedAll EmbedAll EmbedAll EmbedAll 4

Указывает, что SOAP будет создаваться без ссылок.Indicates that SOAP will be generated without references. Этот параметр на данный момент не реализован.This option is currently not implemented.

None None None None 0

Параметр по умолчанию, указывающий, что дополнительные параметры не выбраны.The default option indicating that no extra options are selected.

Option1 Option1 Option1 Option1 8

Открытый зарезервированный параметр для временных условий взаимодействия; использование будет изменено.Public reserved option for temporary interop conditions; the use will change.

Option2 Option2 Option2 Option2 16

Открытый зарезервированный параметр для временных условий взаимодействия; использование будет изменено.Public reserved option for temporary interop conditions; the use will change.

XsdString XsdString XsdString XsdString 2

Указывает, что тип выходной строки SOAP в конверте SOAP использует префикс XSD, и что в полученном XML отсутствует атрибут ID для строки.Indicates that the output SOAP string type in a SOAP Envelope uses the XSD prefix, and that the resulting XML does not have an ID attribute for the string.

Комментарии

SoapOption Перечисление используется для указания инструкций .NET Framework о том, как она создает SOAP.The SoapOption enumeration is used to specify instructions to the .NET Framework on how it will generate the SOAP.

Например, хотя класс по умолчанию (со SoapOptions.None значением перечисления) может быть удален в формате SOAP следующим образом:For example, while a class by default (with the SoapOptions.None enumeration value) might be remoted in the SOAP format as:

<member1>10</member1>  
<member2 id="ref-3">hello</member2>  
<member3 href="#ref-3"/>  
<member4 href="#ref-4"/>  
<member4shared href="#ref-4"/>  
<member5 href="#ref-5"/>  
<member6 id="ref-6" xsi:type="SOAP-ENC:string">Hello World</member6>  
<str1 id="ref-7">hello &#60; world</str1>  
<str2 id="ref-8">&#60;</str2>  
<str3 id="ref-9">&#60; world</str3>  
<str4 href="#ref-7"/>  

Удаленная сериализация с SoapOptions.XsdString параметром создает следующий XML-код:Remoting serialization with the SoapOptions.XsdString option produces the following XML:

<member1 xsi:type="xsd:int">10</member1>  
<member2 xsi:type="xsd:string">hello</member2>  
<member3 xsi:type="xsd:string">hello</member3>  
<member4 href="#ref-3"/>  
<member4shared href="#ref-3"/>  
<member5 href="#ref-4"/>  
<member6 xsi:type="xsd:string">Hello World</member6>  
<str1 xsi:type="xsd:string">hello &#60; world</str1>  
<str2 xsi:type="xsd:string">&#60;</str2>  
<str3 xsi:type="xsd:string">&#60; world</str3>  
<str4 xsi:type="xsd:string">hello &#60; world</str4>  

Дополнительные сведения о конвертах SOAP см. в разделе www.w3.org/tr/soap/#_Toc478383494.For more information about SOAP envelopes, see www.w3.org/tr/soap/#_Toc478383494.

Применяется к