XObject.Annotation Método

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Sobrecargas

Annotation(Type)	Obtém o primeiro objeto de anotação do tipo especificado desse XObject.
Annotation<T>()	Obtém o primeiro objeto de anotação do tipo especificado desse XObject.

Annotation(Type)

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.

public:
 System::Object ^ Annotation(Type ^ type);

public object Annotation (Type type);

public object? Annotation (Type type);

member this.Annotation : Type -> obj

Public Function Annotation (type As Type) As Object

Parâmetros

type

Type

O tipo da anotação a ser recuperada.

Retornos

Object

O Object que contém o primeiro objeto de anotação que corresponde ao tipo especificado ou null se nenhuma anotação for do tipo especificado.

Exemplos

O exemplo a seguir adiciona uma anotação a um XElement. Em seguida, ele recupera a anotação, especificando o tipo a ser recuperado.

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(typeof(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(GetType(MyAnnotation)), MyAnnotation)  
        Console.WriteLine(ma2.Tag)  
    End Sub  

End Module  

Esse exemplo gera a saída a seguir:

T1  

Confira também

• Visão geral do LINQ to XML

Annotation<T>()

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.

public:
generic <typename T>
 where T : class T Annotation();

public T Annotation<T> () where T : class;

public T? Annotation<T> () where T : class;

member this.Annotation : unit -> 'T (requires 'T : null)

Public Function Annotation(Of T As Class) () As T

Parâmetros de tipo

T

O tipo da anotação a ser recuperada.

Retornos

T

O primeiro objeto de anotação que corresponde ao tipo especificado ou null se nenhuma anotação for do tipo especificado.

Exemplos

O exemplo a seguir adiciona uma anotação a um elemento e, em seguida, recupera-a por meio desse método.

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 = 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 = root.Annotation(Of MyAnnotation)()  
        Console.WriteLine(ma2.Tag)  
    End Sub  
End Module  

Esse exemplo gera a saída a seguir:

T1  

Confira também

• Visão geral do LINQ to XML