XObject.AddAnnotation(Object) Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Anmerkungsliste dieses XObject ein Objekt hinzu.
public:
void AddAnnotation(System::Object ^ annotation);public void AddAnnotation (object annotation);member this.AddAnnotation : obj -> unitPublic Sub AddAnnotation (annotation As Object)- annotation
- Object
Ein Objekt, das die hinzuzufügende Anmerkung enthält.
Im folgenden Beispiel wird eine Anmerkung zu einem XElementhinzugefügt.
public class MyAnnotation {
private string tag;
public string Tag {get{return tag;} set{tag=value;}}
public MyAnnotation(string tag) {
this.tag = tag;
}
}
public class Program {
public static void Main(string[] args) {
MyAnnotation ma = new MyAnnotation("T1");
XElement root = new XElement("Root", "content");
root.AddAnnotation(ma);
MyAnnotation ma2 = (MyAnnotation)root.Annotation<MyAnnotation>();
Console.WriteLine(ma2.Tag);
}
}
Public Class MyAnnotation
Private _tag As String
Property Tag() As String
Get
Return Me._tag
End Get
Set(ByVal Value As String)
Me._tag = Value
End Set
End Property
Public Sub New(ByVal tag As String)
Me._tag = tag
End Sub
End Class
Module Module1
Sub Main()
Dim ma As MyAnnotation = New MyAnnotation("T1")
Dim root As XElement = <Root>content</Root>
root.AddAnnotation(ma)
Dim ma2 As MyAnnotation = DirectCast(root.Annotation(Of MyAnnotation)(), MyAnnotation)
Console.WriteLine(ma2.Tag)
End Sub
End Module
Dieses Beispiel erzeugt die folgende Ausgabe:
T1
Beachten Sie, dass Anmerkungen nicht Teil des Infosets sind; sie bleiben nicht beibehalten oder werden von ToString. Wenn Sie auch einen XML-Namespace in Ihr VB-Projekt importieren und AddAnnotation mit dem Enumerationswert SaveOptions.OmitDuplicateNamespaces aufrufen, enthält nur ein Element anstelle jedes Elements das XML-Namespace-Attribut. Weitere Informationen finden Sie unter Entfernen doppelter Namespaces in XML Literals.
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |