SoapFieldAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Remoting.Metadata

Zestaw:

mscorlib.dll

Dostosowuje generowanie i przetwarzanie protokołu SOAP dla pola. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

Attribute

SoapAttribute

SoapFieldAttribute

Atrybuty

AttributeUsageAttribute ComVisibleAttribute

Przykłady

W poniższym przykładzie kodu pokazano dostosowanie protokołu SOAP wygenerowanego dla pola klasy z elementem SoapFieldAttribute. Protokół SOAP można wygenerować za pomocą kodu pokazanego w przykładzie SerializableAttribute klasy.

[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

Uwagi

Obiekty docelowe atrybutu SoapFieldAttribute są polami obiektów. Atrybut służy do określania SoapFieldAttribute informacji, które kontrolują sposób generowania formatu przewodu XML protokołu SOAP dla pól docelowych.

Konstruktory

SoapFieldAttribute()

Tworzy wystąpienie SoapFieldAttribute klasy.

Pola

ProtXmlNamespace	Przestrzeń nazw XML, do której element docelowy bieżącego atrybutu SOAP jest serializowany. (Odziedziczone po SoapAttribute)
ReflectInfo	Obiekt odbicia używany przez klasy atrybutów pochodzące z SoapAttribute klasy do ustawiania informacji o serializacji XML. (Odziedziczone po SoapAttribute)

Właściwości

Embedded	Pobiera lub ustawia wartość wskazującą, czy typ musi być zagnieżdżony podczas serializacji protokołu SOAP. (Odziedziczone po SoapAttribute)
Order	Pobiera lub ustawia kolejność bieżącego atrybutu pola.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
UseAttribute	Pobiera lub ustawia wartość wskazującą, czy element docelowy bieżącego atrybutu będzie serializowany jako atrybut XML zamiast pola XML. (Odziedziczone po SoapAttribute)
XmlElementName	Pobiera lub ustawia nazwę elementu XML pola zawartego w atrybucie SoapFieldAttribute .
XmlNamespace	Pobiera lub ustawia nazwę przestrzeni nazw XML. (Odziedziczone po SoapAttribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
IsInteropXmlElement()	Zwraca wartość wskazującą, czy bieżący atrybut zawiera wartości elementów XML międzyoperacyjnej.
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do pobrania informacji o typie interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)