SoapFieldAttribute Класс

Определение

Пространство имен:

System.Runtime.Remoting.Metadata

Сборка:

mscorlib.dll

Настраивает создание и обработку SOAP для поля. Этот класс не наследуется.

public ref class SoapFieldAttribute sealed : System::Runtime::Remoting::Metadata::SoapAttribute

[System.AttributeUsage(System.AttributeTargets.Field)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Field)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute

Наследование

Object

Attribute

SoapAttribute

SoapFieldAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере кода демонстрируется настройка SOAP, созданного для поля класса с помощью SoapFieldAttributeобъекта. SOAP можно производить с помощью кода, показанного SerializableAttribute в примере класса.

[Serializable]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public ref class TestSimpleObject
{
public:
   int member1;

   [SoapFieldAttribute(XmlElementName="MyXmlElement")] String^ member2;

   String^ member3;
   double member4;

   // A field that is not serialized.

   [NonSerialized] String^ member5;

   TestSimpleObject()
   {
      member1 = 11;
      member2 = "hello";
      member3 = "hello";
      member4 = 3.14159265;
      member5 = "hello world!";
   }
};

[Serializable()]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public class TestSimpleObject  {

    public int member1;

    [SoapFieldAttribute(XmlElementName="MyXmlElement")] public string member2;

    public string member3;
    public double member4;

    // A field that is not serialized.
    [NonSerialized()] public string member5;

    public TestSimpleObject() {

        member1 = 11;
        member2 = "hello";
        member3 = "hello";
        member4 = 3.14159265;
        member5 = "hello world!";
    }
}

<Serializable(), SoapTypeAttribute(XmlNamespace := "MyXmlNamespace")> Public Class TestSimpleObject
   
   Public member1 As Integer

   <SoapFieldAttribute(XmlElementName := "MyXmlElement")> Public member2 As String
   
   Public member3 As String
   Public member4 As Double

   ' A field that is not serialized.
   <NonSerialized()> Public member5 As String  


   Public Sub New()
      member1 = 11
      member2 = "hello"
      member3 = "hello"
      member4 = 3.14159265
      member5 = "hello world!"
   End Sub

End Class

Комментарии

Целевые объекты для атрибута SoapFieldAttribute — это поля объектов. Атрибут SoapFieldAttribute используется для указания сведений о том, как платформа .NET Framework создает формат провода SOAP XML для целевых полей.

Конструкторы

Имя	Описание
SoapFieldAttribute()	Создает экземпляр SoapFieldAttribute класса.

Поля

Имя	Описание
ProtXmlNamespace	Пространство имен XML, в которое сериализуется целевой объект текущего атрибута SOAP. (Унаследовано от SoapAttribute)
ReflectInfo	Объект отражения, используемый классами атрибутов, производными от SoapAttribute класса, для задания сведений о сериализации XML. (Унаследовано от SoapAttribute)

Свойства

Имя	Описание
Embedded	Возвращает или задает значение, указывающее, должен ли тип быть вложен во время сериализации SOAP. (Унаследовано от SoapAttribute)
Order	Возвращает или задает порядок текущего атрибута поля.
TypeId	При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute)
UseAttribute	Возвращает или задает значение, указывающее, сериализуется ли целевой объект текущего атрибута в виде XML-атрибута вместо поля XML. (Унаследовано от SoapAttribute)
XmlElementName	Возвращает или задает имя XML-элемента поля, содержащегося в атрибуте SoapFieldAttribute .
XmlNamespace	Возвращает или задает имя пространства имен XML. (Унаследовано от SoapAttribute)

Методы

Имя	Описание
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
IsInteropXmlElement()	Возвращает значение, указывающее, содержит ли текущий атрибут значения XML-элемента взаимодействия.
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute)