XmlArrayAttribute.IsNullable プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlArrayAttribute.IsNullable プロパティ

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

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property IsNullable As
 Boolean

Visual Basic (使用法)

Dim instance As XmlArrayAttribute
Dim value As Boolean

value = instance.IsNullable

instance.IsNullable = value

public bool IsNullable { get;
 set; }

C++

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

/** @property */
public boolean get_IsNullable ()

/** @property */
public void set_IsNullable (boolean value)

JScript

public function get IsNullable
 () : boolean

public function set IsNullable
 (value : boolean)

プロパティ値
XmlSerializer が xsi:nil 属性を生成する場合は true。それ以外の場合は false。

解説

XML スキーマで構造を指定することにより、XML ドキュメントで、要素の内容が欠落していることを明示的に知らせることができます。このような要素には、true に設定された属性 xsi:nil が含まれます。詳細については、W3C (World Wide Web Consortium) のサイト (www.w3.org) で『XML Schema Part 1: Structures』という仕様を参照してください。

IsNullable プロパティが true に設定されている場合は、null 参照 (Visual Basic では Nothing) に設定されているクラスメンバに対して xsi:nil 属性が生成されます。たとえば、MyStringArray というフィールドを null 参照 (Visual Basic では Nothing) に設定すると、XmlSerializer は次の XML コードを生成します。

 <MyStringArray xsi:nil = "true" />

IsNullable プロパティが false に設定されている場合は、XML 要素が生成されません。

メモ
値型には null 参照 (Visual Basic では Nothing) を指定できないため、IsNullable プロパティは、値型として指定されたメンバには適用できません。

使用例

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

Visual Basic

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

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

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

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

C++

public ref class MyClass
{
public:

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

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

public class MyClass
{
    /** @attribute XmlArray(IsNullable = true)
     */
    public String isNullableIsTrueArray[];

    /** @attribute XmlArray(IsNullable = false)
     */
    public String isNullableIsFalseArray[];
} //MyClass