XmlArrayAttribute.IsNullable 属性

定义

命名空间:

System.Xml.Serialization

程序集:

netstandard.dll, System.Xml.XmlSerializer.dll

Source:

XmlArrayAttribute.cs

获取或设置一个值，该值指示 XmlSerializer 必须将成员序列化为空 XML 标记，并将 xsi:nil 属性设置为 true。

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

如果生成属性，则为 ;否则为 。

示例

以下示例包含两个数组：一个数组的属性 IsNullable 设置为 true，另一个数组的属性 IsNullable 设置为 false。

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的类成员生成该属性。 例如，如果设置了一MyStringArraynull个名为的字段，则XmlSerializer生成以下 XML 代码。

<MyStringArray xsi:nil = "true" />

IsNullable如果该属性为false，则不生成 XML 元素。

注释

不能将 IsNullable 属性应用于类型为值类型的成员，因为值类型不能包含 null。