SoapElementAttribute.IsNullable プロパティ

XmlSerializer が、 null 参照 (Visual Basic では Nothing) に設定されているメンバを、"1" に設定されている xsi:null 属性にシリアル化するかどうかを示す値を取得または設定します。

Public Property IsNullable As Boolean
[C#]
public bool IsNullable {get; set;}
[C++]
public: __property bool get_IsNullable();public: __property void set_IsNullable(bool);
[JScript]
public function get IsNullable() : Boolean;public function set IsNullable(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 参照 (Nothing) に設定すると、 XmlSerializer は次の XML コードを生成します。

<MyStringArray xsi:null = "1" />

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

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

必要条件

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

参照

SoapElementAttribute クラス | SoapElementAttribute メンバ | System.Xml.Serialization 名前空間