XmlIgnoreAttribute Sınıf

  • Başvuru

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

yönteminin Serialize(TextWriter, Object) XmlSerializer ortak alanı veya genel okuma/yazma özellik değerini seri hale getirmemesi için yönerge verir.

public ref class XmlIgnoreAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class XmlIgnoreAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)>]
type XmlIgnoreAttribute = class
    inherit Attribute
Public Class XmlIgnoreAttribute
Inherits Attribute
Devralma
Object
Attribute
XmlIgnoreAttribute
Öznitelikler
AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte adlı bir alan Commentiçeren adlı Groupbir sınıf gösterilmektedir. Örnek, alanına öğesini atar XmlIgnoreAttribute ve böylece sınıfın bir örneğini serileştirirken veya seri durumdan çıkarırken alanını yoksaymasını bildirir XmlSerializer .

public ref class Group
{
public:

   // The XmlSerializer ignores this field.

   [XmlIgnore]
   String^ Comment;

   // The XmlSerializer serializes this field.
   String^ GroupName;
};

public class Group
{
   // The XmlSerializer ignores this field.
   [XmlIgnore]
   public string Comment;

   // The XmlSerializer serializes this field.
   public string GroupName;
}

Public Class Group
    ' the XmlSerializer ignores this field.
    <XmlIgnore()> Public Comment As String
    
    ' The XmlSerializer serializes this field.
    Public GroupName As String
End Class

Açıklamalar

, XmlIgnoreAttribute bir nesneyi seri hale getirme veya seri durumdan çıkarma işlemini XmlSerializer denetleen bir öznitelik ailesine aittir. bir sınıfın XmlIgnoreAttribute herhangi bir üyesine uygularsanız, XmlSerializer sınıfın bir örneğini serileştirir veya seri durumdan çıkarırken üyeyi yoksayar. Benzer özniteliklerin tam listesi için bkz. XML Serileştirmesini Denetleen Öznitelikler.

bir XmlAttributes nesnesi oluşturup özelliğini falseolarak ayarlayarakXmlIgnore' ın neden olduğu XmlIgnoreAttribute davranışı geçersiz kılabilirsiniz. nesnesini sınıfın XmlAttributes bir örneğine göre XmlAttributeOverrides oluşturmanız gerekirAdd. Son olarak, veya Deserialize yöntemlerini çağırmadan Serialize önce sınıfının bir örneğini XmlSerializer oluşturmak için nesnesini kullanmanız XmlAttributeOverrides gerekir.

XML Şema Tanımı Aracı (Xsd.exe) bazen bir şema dosyasından (.xsd) sınıf oluştururken öğesini oluştururXmlIgnoreAttribute. Bu davranış, değer türleri olarak nullayarlanamadığı için oluşur, ancak tüm XML veri türleri olabilir. Bu nedenle, araç bir değer türüyle eşlenen bir XML türüyle karşılaştığında iki alan oluşturur: biri değeri tutmak için ve biçimini fieldnameSpecifiedalan veya özelliğin adıyla değiştirildiği fieldname başka bir özel alan. Ancak, bu özel alanın yalnızca şema öğenin en düşük oluşuma (minOccurs = "0") sahip olmadığını ve öğenin varsayılan değeri olmadığını belirttiğinde oluşturulduğuna dikkat edin. Bu XmlSerializer özel alanı ayarlar ve denetler ve alan veya özellik için bir değer ayarlanıp ayarlanmadığını belirler. Özel alanın seri hale getirilmemesi gerektiğinden, araç bunu buna uygular XmlIgnoreAttribute .

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Not

sözcüğünü XmlIgnore kodunuzda daha uzun XmlIgnoreAttributeyerine kullanabilirsiniz.

Oluşturucular

XmlIgnoreAttribute()

XmlIgnoreAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)

Yöntemler

Equals(Object)

Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür.

(Devralındığı yer: Attribute)
GetHashCode()

Bu örneğe ilişkin karma kodu döndürür.

(Devralındığı yer: Attribute)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
IsDefaultAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir.

(Devralındığı yer: Attribute)
Match(Object)

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.

(Devralındığı yer: Attribute)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1).

(Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır

Ayrıca bkz.