XmlElementAttribute.IsNullable プロパティ

定義

XmlSerializer が、null に設定されているメンバーを、xsi:nil 属性が true に設定されている空タグとしてシリアル化する必要があるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the XmlSerializer must serialize a member that is set to null as an empty tag with the xsi:nil attribute set to 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

プロパティ値

XmlSerializertrue 属性を生成する場合は xsi:nil。それ以外の場合は falsetrue if the XmlSerializer generates the xsi:nil attribute; otherwise, false.

次の例は、 XmlElementAttributeが適用されたフィールドIsNullableと、にfalse設定されたプロパティを示しています。The following example shows a field with the XmlElementAttribute applied to it, and the IsNullable property set to 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 ドキュメントが要素のコンテンツが欠落していることを明示的に通知できます。The XML schema specification for structures allows an XML document to explicitly signal that an element's content is missing. このような要素にはxsi:nil 、属性trueがに設定されています。Such an element contains the attribute xsi:nil set to true. 詳細については、「XML Schema Part 1:」の World Wide Web コンソーシアム仕様を参照してください。構造体。For more information, see the World Wide Web Consortium specification, XML Schema Part 1: Structures.

プロパティがにtrue設定されているxsi:nil場合は、にnull設定されているクラスメンバーに対して属性が生成されます。 IsNullableIf the IsNullable property is set to true, the xsi:nil attribute is generated for class members that have been set to null. たとえば、という名前MyStringArrayのフィールドをにnull設定すると、によっXmlSerializerて次の XML コードが生成されます。For example if you set a field named MyStringArray to null, the XmlSerializer generates the following XML code.

<MyStringArray xsi:nil = "true" />  

プロパティがfalseの場合、にnull設定されているクラスメンバーに対して XML 要素は生成されません。 IsNullableIf the IsNullable property is false, no XML element is generated for class members that have been set to null.

注意

値型にをIsNullable含めるnullことはできないため、プロパティを値型として型指定されたメンバーに適用することはできません。You cannot apply the IsNullable property to a member typed as a value type because a value type cannot contain null. また、null 許容値型の場合false 、このプロパティをに設定することはできません。Additionally, you cannot set this property to false for nullable value types. このような型nullがの場合、をに設定xsi:nilするtrueことによってシリアル化されます。When such types are null, they will be serialized by setting xsi:nil to true.

適用対象