Attributes

Attributes是用來註釋(annotation) assemblies, typs, members and parameters

使用中刮號[]加在要被註釋的元件上面，如下

[AttributeUsage(...)]
public class NameAttribute : Attribute{
    ...
}

並且可以不只一個Attributes

1. 繼承Attribute，並且於檔案名稱後面加上Attribute

public class NameAttribute : Attribute

1. 使用AttributeUsageAttribute來客製化

[AttributeUsage(...)]
public class NameAttribute

1. 非必要選項提供set
   如下面例子，Age不是必填，所以提供set

public class NameAttribute : Attribute{
    public int Age {get{...} set{...}}
}

1. 必要選項只提供get，由建構子給值
   必填欄位不要輕易提供set讓任何人修改，反而是在建構子給值
   這樣在new一個NameAttribute就能確保userName有值

public class NameAttribute : Attribute{
    public NameAttribute(string userName) {...}
    public string UserName { get{....} }
}

1. 延續上面兩個規則，請避免在建構子中傳入非必填的值
   不要這樣，Age不是必填，所以給了set，卻又在建構子強制給值

// Don't do this
public class NameAttribute : Attribute{
    public NameAttribute(int age) {...}
    public int Age {get{...} set{...}}
}

2. 避免overload客制的建構子

3. 如果要加快搜尋速度，苦以使用sealed

public sealed class NameAttribute : Attribute {...}

Uri

Uri 全名為 uniform resource identifier，用字串來識別資源

1. 使用System.Uri表示URI 及 URL

2. 傳入Uri型態的方法，可以考慮多加一個傳入string的overload

public void NavigeteTo(Uri location){...}
pubilc void NavageteTo(string location){
    NavigeteTo(new Uri(location);
}

3. 但是不要每個傳入Uri型態的方法，都多一個string的overload
   根據需要的情境選擇性overload即可

4. 實做System.Uri時，call the Uri-based overloads

5. 不要把URI/URL資料存成string
   即使傳入string，也要轉換成Uri使用

public class SomeResource{
    Uri location;
    public SomeResource(string location){
        this.location = new Uri(location);
    }
    public SomeResource(Uri location){
        this.location = new location;
    }
}