XmlElementAttribute.IsNullable Özellik

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kod:

System.Xml.XmlSerializer.dll

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

özniteliği olarak ayarlanmış boş bir etiket xsi:nil olarak ayarlanmış bir üyeyi XmlSerializer seri hale getirmesi null gerekip gerekmediğini belirten bir değer alır veya ayarlartrue.

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

Özellik Değeri

Boolean

true özniteliğini XmlSerializer oluşturursa xsi:nil ; değilse, false.

Örnekler

Aşağıdaki örnekte, uygulanan bir alan ve IsNullable özelliği olarak ayarlanmış falsebir alan XmlElementAttribute gösterilmektedir.

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

Açıklamalar

Yapıların XML şema belirtimi, XML belgesinin bir öğenin içeriğinin eksik olduğunu açıkça belirtmesine olanak tanır. Böyle bir öğe olarak ayarlanmış trueözniteliğini xsi:nil içerir. Daha fazla bilgi için bkz. World Wide Web Konsorsiyum belirtimi, XML Şeması Bölüm 1: Yapılar.

IsNullable özelliği olarak true``xsi:nil ayarlanırsa, özniteliği olarak ayarlanmış nullsınıf üyeleri için oluşturulur. Örneğin, adlı MyStringArray nullbir alan ayarlarsanız, aşağıdaki XmlSerializer XML kodunu oluşturur.

<MyStringArray xsi:nil = "true" />  

IsNullable özelliği isefalse, olarak ayarlanmış nullsınıf üyeleri için hiçbir XML öğesi oluşturulmaz.

Not

Bir değer türü içeremediğindennull, özelliğini değer türü olarak yazılan üyeye uygulayamazsınızIsNullable. Ayrıca, null atanabilir değer türleri için bu özelliği false olarak ayarlayamazsınız. Bu tür türler nullolduğunda, olarak ayarlanarak xsi:nil trueseri hale getirilirler.