XmlArrayAttribute.IsNullable プロパティ

定義

名前空間:

System.Xml.Serialization

アセンブリ:

System.Xml.XmlSerializer.dll

Source:

XmlArrayAttribute.cs

XmlSerializer で、xsi:nil 属性が true に設定された空の XML タグとしてメンバーをシリアル化する必要があるかどうかを示す値を取得または設定します。

public:
 property bool IsNullable { bool get(); void set(bool value); };

public bool IsNullable { get; set; }

member this.IsNullable : bool with get, set

Public Property IsNullable As Boolean

プロパティ値

Boolean

XmlSerializer が true 属性を生成する場合は xsi:nil。それ以外の場合は false。

例

次の例には、2 つの配列が含まれています。1 つは プロパティが IsNullable に true設定され、もう 1 つは プロパティが IsNullable に false設定されています。

public ref class MyClass
{
public:

   [XmlArray(IsNullable=true)]
   array<String^>^IsNullableIsTrueArray;

   [XmlArray(IsNullable=false)]
   array<String^>^IsNullableIsFalseArray;
};

public class MyClass
{
   [XmlArray (IsNullable = true)]
   public string [] IsNullableIsTrueArray;

   [XmlArray (IsNullable = false)]
   public string [] IsNullableIsFalseArray;
}

Public Class MyClass1
    <XmlArray(IsNullable := True)> _
    Public IsNullableIsTrueArray() As String

    <XmlArray(IsNullable := False)> _
    Public IsNullableIsFalseArray() As String
End Class

注釈

構造体の XML スキーマ仕様を使用すると、XML ドキュメントは要素のコンテンツが見つからないことを明示的に通知できます。 このような要素には、 に設定trueされた 属性xsi:nilが含まれています。 詳細については、「 XML スキーマ パート 1: 構造体」というタイトルの World Wide Web Consortium 仕様を参照してください。

プロパティが IsNullable にtruexsi:nil設定されている場合、属性は に設定されているクラス メンバーに対してnull生成されます。 たとえば、 という名前 MyStringArray のフィールドを に null設定すると、 によって XmlSerializer 次の XML コードが生成されます。

<MyStringArray xsi:nil = "true" />  

プロパティが の IsNullable 場合、 falseXML 要素は生成されません。

Note

値型として型指定されたメンバーに プロパティを適用 IsNullable することはできません。値型には を含 nullめることはできません。