XmlIgnoreAttribute Sınıf
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.
Serialize(TextWriter, Object) XmlSerializer yöntemine genel alanı veya genel okuma/yazma özelliği değerini seri hale getirmeme talimatı 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 AttributePublic Class XmlIgnoreAttribute
Inherits Attribute- Devralma
- Öznitelikler
Örnekler
Aşağıdaki örnekte adlı Groupbir alan Commentiçeren adlı bir sınıf gösterilmektedir. Örnek, alanına öğesini atar XmlIgnoreAttribute ve böylece sınıfının bir örneğini seri hale getirerek veya seri durumdan çıkarırken alanını yoksaymasını bildirir XmlSerializer .
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 nesnenin seri hale nasıl getirildiğini veya seri durumdan XmlSerializer çıkarıldığını 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.
nesnesini XmlAttributes oluşturup özelliğini falseolarak ayarlayarakXmlIgnore, 'nin XmlIgnoreAttribute neden olduğu davranışı geçersiz kılabilirsiniz. nesnesini sınıfın XmlAttributes bir örneğine göndermeniz XmlAttributeOverrides 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), zaman zaman 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üne 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. , XmlSerializer alan veya özellik için bir değer ayarlanıp ayarlanmadığını belirlemek için bu özel alanı ayarlar ve denetler. Özel alanın seri hale getirilmemesi gerektiğinden, araç bunu ona uygular XmlIgnoreAttribute .
Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.
Uyarı
uzun yerine XmlIgnoreAttributekodunuzda sözcüğünü XmlIgnore kullanabilirsiniz.
Oluşturucular
| Name | Description |
|---|---|
| XmlIgnoreAttribute() |
XmlIgnoreAttribute sınıfının yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| Equals(Object) |
Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute) |
| GetHashCode() |
Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute) |
| GetType() |
Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
| Name | Description |
|---|---|
| _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 kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute) |
