Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XmlIgnoreAttribute-Klasse

 

Weist die Serialize Methode der XmlSerializer der öffentliches Feld oder einer öffentlichen Lese-/Schreib-Eigenschaftswert nicht zu serialisieren.

Namespace:   System.Xml.Serialization
Assembly:  System.Xml (in System.Xml.dll)

System.Object
  System.Attribute
    System.Xml.Serialization.XmlIgnoreAttribute

[AttributeUsageAttribute(AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.ReturnValue)]
public class XmlIgnoreAttribute : Attribute

NameBeschreibung
System_CAPS_pubmethodXmlIgnoreAttribute()

Initialisiert eine neue Instanz der XmlIgnoreAttribute-Klasse.

NameBeschreibung
System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Die XmlIgnoreAttribute gehört zu einer Familie von Attributen, die steuert, wie die XmlSerializer Serialisieren oder Deserialisieren ein Objekts. Wenden Sie die XmlIgnoreAttribute auf einen Member einer Klasse, die XmlSerializer ignoriert das Element bei der Serialisierung oder Deserialisierung einer Instanz der Klasse. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute zur Steuerung der XML-Serialisierung.

Sie können das Verhalten verursacht durch Überschreiben der XmlIgnoreAttribute erstellen ein XmlAttributes -Objekt und legt seine XmlIgnore -Eigenschaft auf false. Sie müssen Add die XmlAttributes Objekt mit einer Instanz von der XmlAttributeOverrides Klasse. Darüber hinaus müssen Sie mithilfe der XmlAttributeOverrides -Objekt, das Erstellen einer Instanz der XmlSerializer -Klasse vor dem Aufrufen der Serialize oder Deserialize Methoden.

Die XML Schema Definition-Tool (Xsd.exe) gelegentlich generiert die XmlIgnoreAttribute beim Erstellen von Klassen aus einer Schemadatei (.xsd). Dieses Verhalten tritt auf, da Werttypen können, um gesetzt werden null, aber alle XML-Datentypen möglich ist. Das Tool erstellt daher zwei Felder, wenn es einen XML-Typ antrifft, der einem Werttyp zugeordnet: eines, das den Wert und eine andere besonderes Feld der Form fieldnameSpecified, wobei die fieldname durch den Namen des Felds oder der Eigenschaft ersetzt wird. Beachten Sie jedoch, dass dieses spezifische Feld nur generiert wird, wenn das Schema angibt, dass das Element nicht auftreten muss (MinOccurs = "0") und das Element keinen Standardwert besitzt. Die XmlSerializer fest und überprüft dieses spezielle Feld aus, um zu bestimmen, ob ein Wert für das Feld oder die Eigenschaft festgelegt wurde. Da das spezielle Feld nicht serialisiert werden muss, wendet das Tool die XmlIgnoreAttribute zu.

Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

System_CAPS_noteHinweis

Sie können das Wort XmlIgnore in Ihrem Code anstelle des längeren XmlIgnoreAttribute.

Das folgende Beispiel zeigt eine Klasse namens Group, enthält ein Feld namens Comment. Im Beispiel wird die XmlIgnoreAttribute zugewiesen, in das Feld der XmlSerializer das Feld beim Serialisieren bzw. Deserialisieren einer Instanz der Klasse ignorieren.

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

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: