XObject.AddAnnotation(Object) Metodo

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Aggiunge un oggetto all'elenco di annotazioni di XObject.

public:
 void AddAnnotation(System::Object ^ annotation);

public void AddAnnotation (object annotation);

member this.AddAnnotation : obj -> unit

Public Sub AddAnnotation (annotation As Object)

Parametri

annotation

Object

Oggetto contenente l'annotazione da aggiungere.

Esempio

Nell'esempio seguente viene aggiunta un'annotazione a un oggetto XElement.

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  

Nell'esempio viene prodotto l'output seguente:

T1  

Commenti

Si noti che le annotazioni non fanno parte dell'infoset; non sono persistenti o visualizzati da ToString. Inoltre, se si importa uno spazio dei nomi XML nel progetto VB e si chiama AddAnnotation con il valore di enumerazione SaveOptions.OmitDuplicateNamespaces, un solo elemento conterrà l'attributo Spazio dei nomi XML anziché ogni elemento. Per altre informazioni, vedere Rimozione di spazi dei nomi duplicati nei valori letterali XML.

Vedi anche

• Panoramica di LINQ to XML