XmlIgnoreAttribute Sınıf

Tanım

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.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• XmlAttributeOverrides
• XmlAttributes
• XmlIgnore
• XmlSerializer
• XML Serileştirmeye Giriş
• Nasıl yapılır: XML Akışı için Alternatif Öğe Adı Belirtme
• Öznitelikleri Kullanarak XML Serileştirmeyi Denetleme
• XML Serileştirme Örnekleri
• XML şema tanımı Aracı (XSD.exe'nin)