SoapFieldAttribute Klasse

Definition

Namespace:

System.Runtime.Remoting.Metadata

Assembly:

mscorlib.dll

Passt die SOAP-Generierung und -Verarbeitung für ein Feld an. Diese Klasse kann nicht vererbt werden.

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

[System.AttributeUsage(System.AttributeTargets.Field)]
public sealed class SoapFieldAttribute : 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)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

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

Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute

Vererbung

Object

Attribute

SoapAttribute

SoapFieldAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel wird die Anpassung von SOAP veranschaulicht, die für ein Feld einer Klasse mit dem SoapFieldAttribute. Die SOAP kann vom Code erstellt werden, der SerializableAttribute im Klassenbeispiel gezeigt wird.

[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

Hinweise

Die Zielobjekte für das SoapFieldAttribute Attribut sind Objektfelder. Das SoapFieldAttribute Attribut wird verwendet, um Informationen anzugeben, die steuern, wie das .NET Framework das SOAP-XML-Drahtformat für Zielfelder generiert.

Konstruktoren

SoapFieldAttribute()

Erstellt eine Instanz einer SoapFieldAttribute-Klasse.

Felder

ProtXmlNamespace	Der XML-Namespace, in den das Ziel des aktuellen SOAP-Attributs serialisiert wird. (Geerbt von SoapAttribute)
ReflectInfo	Ein Reflektionsobjekt, das von von der SoapAttribute-Klasse abgeleiteten Attributklassen zum Festlegen von XML-Serialisierungsinformationen verwendet wird. (Geerbt von SoapAttribute)

Eigenschaften

Embedded	Ruft einen Wert ab, der angibt, ob der Typ während der SOAP-Serialisierung geschachtelt werden muss, oder legt diesen fest. (Geerbt von SoapAttribute)
Order	Ruft die Reihenfolge des aktuellen Feldattributs ab oder legt diese fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
UseAttribute	Ruft einen Wert ab, der angibt, ob das Ziel des aktuellen Attributs nicht als XML-Feld, sondern als XML-Attribut serialisiert wird, oder legt diesen fest. (Geerbt von SoapAttribute)
XmlElementName	Ruft den XML-Elementnamen des im SoapFieldAttribute-Attribut enthaltenen Felds ab oder legt diesen fest.
XmlNamespace	Ruft den XML-Namespacenamen ab oder legt diesen fest. (Geerbt von SoapAttribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
IsInteropXmlElement()	Gibt einen Wert zurück, der angibt, ob das aktuelle Attribut Interop-XML-Elementwerte enthält.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)