XObject.Annotation 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

組件:

System.Xml.Linq.dll

組件:

netstandard.dll

多載

Annotation(Type)	從此 XObject 取得指定類型的第一個註釋物件。
Annotation<T>()	從此 XObject 取得指定類型的第一個註釋物件。

Annotation(Type)

從此 XObject 取得指定類型的第一個註釋物件。

C#

public object Annotation (Type type);

C#

public object? Annotation (Type type);

參數

type

Type

要擷取的註釋類型。

傳回

Object

Object，包含符合指定類型的第一個註釋物件，如果沒有指定類型的註釋，則為 null。

範例

下列範例會將批註新增至 XElement 。 然後它會擷取批註，並指定要擷取的類型。

C#

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);  
    }  
}  

這個範例會產生下列輸出：

T1  

另請參閱

• LINQ to XML 概觀

Annotation<T>()

從此 XObject 取得指定類型的第一個註釋物件。

C#

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

C#

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

類型參數

T

要擷取的註釋類型。

傳回

T

符合指定類型的第一個註釋物件，或者如果沒有指定類型的註釋，則為 null。

範例

下列範例會將注釋新增至元素，然後透過此方法擷取。

C#

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);  
    }  
}  

這個範例會產生下列輸出：

T1  

另請參閱

• LINQ to XML 概觀