XmlArrayAttribute.IsNullable プロパティ

.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

C#

public bool IsNullable { get;
 set; }

C++

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

J#

/** @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

C#

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;
};

J#

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlArrayAttribute クラス
XmlArrayAttribute メンバ
System.Xml.Serialization 名前空間