SoapOption Перечисление

  • Ссылка

Определение

Пространство имен:
System.Runtime.Remoting.Metadata
Сборка:
mscorlib.dll

Задает параметры конфигурации SOAP для использования с классом SoapTypeAttribute.

Это перечисление поддерживает побитовую комбинацию значений его членов.

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

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

Поля

AlwaysIncludeTypes 1

Указывает, что тип всегда будет включаться в элементы SOAP. Этот параметр полезен при выполнении взаимодействия SOAP с реализациями SOAP, которым необходимы типы для всех элементов.
EmbedAll 4

Указывает, что SOAP будет создаваться без ссылок. Этот параметр на данный момент не реализован.
None 0

Параметр по умолчанию, указывающий, что дополнительные параметры не выбраны.
Option1 8

Открытый зарезервированный параметр для временных условий взаимодействия; использование будет изменено.
Option2 16

Открытый зарезервированный параметр для временных условий взаимодействия; использование будет изменено.
XsdString 2

Указывает, что тип выходной строки SOAP в конверте SOAP использует префикс XSD, и что в полученном XML отсутствует атрибут ID для строки.

Комментарии

Перечисление SoapOption используется для указания инструкций для .NET Framework по созданию SOAP.

Например, класс по умолчанию (со значением SoapOptions.None перечисления) может быть удален в формате SOAP следующим образом:

<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-код:

<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.

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