XmlArrayAttribute.IsNullable プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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, setPublic Property IsNullable As 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めることはできません。
適用対象
.NET