SoapElementAttribute.IsNullable プロパティ

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

SoapElementAttribute.IsNullable プロパティ

XmlSerializer が、xsi:null 属性が "1" に設定されているメンバをシリアル化する必要があるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property IsNullable As
 Boolean

Visual Basic (使用法)

Dim instance As SoapElementAttribute
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:null 属性を生成する場合は true。それ以外の場合は false。

解説

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

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

 <MyStringArray xsi:null = "1" />

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

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

プラットフォーム

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

参照

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