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.

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