XmlElementAttribute.IsNullable 属性

  • 参考

定义

命名空间:
System.Xml.Serialization
程序集:
System.Xml.XmlSerializer.dll
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll

获取或设置一个值，该值指示 XmlSerializer 是否必须将设置为 null 的成员序列化为 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

如果 XmlSerializer 生成 true 属性，则为 xsi:nil；否则为 false。

示例

以下示例显示了一个字段，其中 XmlElementAttribute 应用了该字段，属性 IsNullable 设置为 false。

public ref class MyClass
{
public:

   [XmlElement(IsNullable=false)]
   String^ Group;
};

public class MyClass
{
   [XmlElement(IsNullable = false)]
   public string Group;
}

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group 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如果该属性为，则为已设置为 null false的类成员生成任何 XML 元素。

备注

不能将 IsNullable 属性应用于类型为值类型的成员，因为值类型不能包含 null。 此外，不能将此属性设置为 false 可为 null 的值类型。 当此类类型为null时，它们将通过设置为xsi:nil``true序列化。

适用于