XmlElementAttribute.IsNullable 属性

定义

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

适用于