Classe XmlIgnoreAttribute (System.Xml.Serialization)

XmlIgnoreAttribute appartiene a una famiglia di attributi che controlla come XmlSerializer serializza o deserializza un oggetto. Se si applica XmlIgnoreAttribute a un qualsiasi membro di una classe, l'XmlSerializer ignora il membro quando serializza o deserializza un'istanza della classe. Per un elenco completo di attributi analoghi, vedere Attributes That Control XML Serialization.

È possibile eseguire l'override del comportamento generato da XmlIgnoreAttribute creando un oggetto XmlAttributes e impostando la proprietà XmlIgnore su false. Utilizzare il metodo Add per aggiungere l'oggetto XmlAttributes a un'istanza della classe XmlAttributeOverrides. Infine, utilizzare l'oggetto XmlAttributeOverrides per creare un'istanza della classe XmlSerializer prima di chiamare il metodo Serialize o Deserialize.

[XML Schema Definition Tool (Xsd.exe) talvolta genera XmlIgnoreAttribute quando crea classi da un file di schema (.xsd). Questo comportamento si verifica poiché non è possibile impostare i tipi dei valori su null, mentre tutti i tipi di dati XML possono assumere tale valore. Di conseguenza, lo strumento crea due campi quando rileva un tipo XML associato a un tipo valore: uno contenente il valore e un altro campo speciale che assume la forma fieldnameSpecified, in cui fieldname viene sostituito dal nome del campo o della proprietà. Questo campo speciale viene tuttavia generato solo quando lo schema specifica che l'elemento non dispone di occorrenze minime (minOccurs = "0") e che non è dotato di valori predefiniti. XmlSerializer imposta e controlla questo campo speciale per determinare se è stato impostato un valore per il campo o la proprietà. Poiché il campo speciale non deve essere serializzato, lo strumento vi applica XmlIgnoreAttribute.

Per ulteriori informazioni sull'utilizzo degli attributi, vedere Estensione di metadati mediante attributi.

Nota
Nel codice è possibile utilizzare la parola XmlIgnore anziché la forma più estesa XmlIgnoreAttribute.

Il seguente esempio mostra una classe di nome Group, che contiene un campo di nome Comment. L'esempio assegna XmlIgnoreAttribute al campo, facendo in modo che XmlSerializer ignori il campo durante la serializzazione o la deserializzazione di un'istanza della classe.

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

    ' The XmlSerializer serializes this field.
    Public GroupName As String
End Class

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

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

public ref class Group
{
public:

   // The XmlSerializer ignores this field.

   [XmlIgnore]
   String^ Comment;

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse