SoapFieldAttribute クラス

フィールドの SOAP 生成および SOAP 処理をカスタマイズします。このクラスは継承できません。

この型のすべてのメンバの一覧については、SoapFieldAttribute メンバ を参照してください。

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

<AttributeUsage(AttributeTargets.Field)>
NotInheritable Public Class SoapFieldAttribute   Inherits SoapAttribute
[C#]
[AttributeUsage(AttributeTargets.Field)]
public sealed class SoapFieldAttribute : SoapAttribute
[C++]
[AttributeUsage(AttributeTargets::Field)]
public __gc __sealed class SoapFieldAttribute : public   SoapAttribute
[JScript]
public
   AttributeUsage(AttributeTargets.Field)
class SoapFieldAttribute extends SoapAttribute

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

SoapFieldAttribute 属性のターゲット オブジェクトは、オブジェクト フィールドです。 SoapFieldAttribute 属性は、.NET Framework がターゲット フィールドの SOAP XML ワイヤ形式を生成する方法を制御する情報を指定するために使用します。

使用例

[Visual Basic, C#, C++] SoapFieldAttribute を使用して、クラスのフィールドに生成される SOAP をカスタマイズする方法のコード例を次に示します。SOAP は、 SerializableAttribute クラスの例に示したコードによって生成できます。

 
<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

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

[C++] 
[Serializable] 
[SoapTypeAttribute(XmlNamespace=S"MyXmlNamespace")]
public __gc class TestSimpleObject 
{
public:
    int member1;

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

    String* member3;
    double member4;

    // A field that is not serialized.
    [NonSerialized]
    String* member5; 

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

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Runtime.Remoting.Metadata

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: Mscorlib (Mscorlib.dll 内)

参照

SoapFieldAttribute メンバ | System.Runtime.Remoting.Metadata 名前空間