XmlElementAttribute.IsNullable 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示 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
属性值
如果 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
序列化。