XmlElementAttribute.IsNullable Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
ö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, setPublic Property IsNullable As BooleanÖzellik Değeri
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.