WCF RIA 服務 （十二）- 數據 2

如何添加元數據類

WCF RIA Services支持對實體類和成員的批註。批註是通過叫做元數據類的局部類來實施的。當我們想批註一個生成的實體類，並在重新生成這個實體類時不想丟失 這些批註，我們使用元數據類。通過使用[MetadataTypeAttribute]屬性來指定一個元數據類。

有兩種方 式來添加元數據類。一種是當添加一個新的Domain Service類時，指定自動生成元數據類。還可以手動添加元數據類。下面就介紹這兩種方式。

通 過使用Domain Service Class模板來添加元數據類

1. 
   
2. 在服務端項目中，添 加一個新建項並選擇Domain Service Class模板。
   
3. 當出現Add New Domain Service Class對話框時，選擇想要公開的實體。
   
4. 勾選Generate associated classes for metadata選框。

點擊OK。就會生成一個Domain service class的文件和一個元數據文件。在元數據類的名字中會包含.metadata，例如：DomainService1.metadata.cs
打 開元數據類並添加一些屬性如下代碼所示：

[MetadataTypeAttribute(typeof(Address.AddressMetadata))] public partial class Address { internal sealed class AddressMetadata { // Metadata classes are not meant to be instantiated. private AddressMetadata() { } public int AddressID; [Required] [StringLength(60)] public string AddressLine1; public string AddressLine2; [Required] [StringLength(30)] public string City; public string CountryRegion; public EntityCollection<customeraddress> CustomerAddresses; public DateTime ModifiedDate; [Required] public string PostalCode; [Exclude] public Guid rowguid; public string StateProvince; } }

手 動添加元數據

1. 
   
2. 在服務端項目中，添加一個新類。這個類的名字應與想要公開的實體類的名字一致。按照慣 例，在名字用包含.metadata。
   
3. 添加關鍵字partial來使類成爲局部類。下面的代碼示例了一個匹配名字爲 Address實體類的局部類。
   
    C# Copy Code public partial class Address { } 
   
   
4. 在 局部類中，創建一個internal類作爲元數據類。如下：
   
   public partial class Address { internal sealed class AddressMetadata { } }
   
   
   
5. 對 局部類添加[MetadataTypeAttribute屬性，幷包含元數據類的類型。代碼如下：
   
    [MetadataTypeAttribute(typeof(Address.AddressMetadata))] public partial class Address { internal sealed class AddressMetadata { } } 
6. 在 元數據類中，添加和實體類中成員屬性同名的成員屬性。
   
7. 對成員屬性添加屬性批註。示例代碼如下：
   
   [MetadataTypeAttribute(typeof(Address.AddressMetadata))] public partial class Address { internal sealed class AddressMetadata { // Metadata classes are not meant to be instantiated. private AddressMetadata() { } public int AddressID; [Required] [StringLength(60)] public string AddressLine1; public string AddressLine2; [Required] [StringLength(30)] public string City; public string CountryRegion; public EntityCollection<customeraddress> CustomerAddresses; public DateTime ModifiedDate; [Required] public string PostalCode; [Exclude] public Guid rowguid; public string StateProvince; } }