XmlArrayAttribute.IsNullable 屬性

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.XmlSerializer.dll

Source:

XmlArrayAttribute.cs

取得或設定值，指出 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, set

Public Property IsNullable As Boolean

屬性值

Boolean

如果 XmlSerializer 產生 true 屬性，則為 xsi:nil，否則為 false。

範例

下列範例包含兩個數組：一個屬性設定為 true ，另一個 IsNullable 將 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 部分的萬維網聯盟規格：結構。

IsNullable如果 屬性設定 true 為 ，則會 xsi:nil 針對已設定 null 為 的類別成員產生 屬性。 例如，如果您將名為 MyStringArray 的欄位設定為 null ，會產生 XmlSerializer 下列 XML 程式碼。

<MyStringArray xsi:nil = "true" />  

IsNullable如果 屬性為 false ，則不會產生 XML 專案。

注意

您無法將 IsNullable 屬性套用至類型為實值型別的成員，因為實值型別不能包含 null 。