XmlArrayAttribute.IsNullable 属性

定义

命名空间:

System.Xml.Serialization

程序集:

System.Xml.XmlSerializer.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

获取或设置一个值，该值指示 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。

示例

以下示例包含两个数组：一个数组，一个数组的属性 IsNullable 设置为 true，另一个数组的属性 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。