SoapFieldAttribute-Klasse

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

Namespace: System.Runtime.Remoting.Metadata
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Field)> _
Public NotInheritable Class SoapFieldAttribute
    Inherits SoapAttribute
'Usage
Dim instance As SoapFieldAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Field)] 
public sealed class SoapFieldAttribute : SoapAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Field)] 
public ref class SoapFieldAttribute sealed : public SoapAttribute

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Field) */ 
public final class SoapFieldAttribute extends SoapAttribute

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Field) 
public final class SoapFieldAttribute extends SoapAttribute

Hinweise

Die Zielobjekte für das SoapFieldAttribute-Attribut sind Objektfelder. Mit dem SoapFieldAttribute-Attribut werden Informationen angegeben, die steuern, wie .NET Framework das SOAP-XML-Übertragungsformat für Zielfelder generiert.

Beispiel

Im folgenden Codebeispiel wird die Anpassung von SOAP-Daten veranschaulicht, die für ein Feld einer Klasse mit dem SoapFieldAttribute generiert wurden. Die SOAP-Daten können mit dem Code erstellt werden, der im Beispiel für die SerializableAttribute-Klasse dargestellt wird.

<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 'New

End Class 'TestSimpleObject

[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 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!";
   }
};

/** @attribute Serializable()
 */
/** @attribute SoapTypeAttribute(XmlNamespace = "MyXmlNamespace")
 */
public class TestSimpleObject
{
    public int member1;

    /** @attribute SoapFieldAttribute(XmlElementName = "MyXmlElement")
     */
    public String member2;
    public String member3;
    public double member4;

    // A field that is not serialized.
    /** @attribute NonSerialized()
     */
    public String member5;

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

Vererbungshierarchie

System.Object
   System.Attribute
     System.Runtime.Remoting.Metadata.SoapAttribute
      System.Runtime.Remoting.Metadata.SoapFieldAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SoapFieldAttribute-Member
System.Runtime.Remoting.Metadata-Namespace