TableAttribute 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將類別指定為與資料庫數據表相關聯的實體類別。
public ref class TableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)]
public sealed class TableAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)>]
type TableAttribute = class
inherit Attribute
Public NotInheritable Class TableAttribute
Inherits Attribute
- 繼承
- 屬性
範例
[Table(Name = "Customers")]
public class Customer
{
// ...
}
<Table(Name:="Customers")> _
Public Class Customer
' ...
End Class
備註
使用屬性 TableAttribute 來指定一個類別為與資料庫資料表或檢視相關聯的實體類別。 LINQ 轉 SQL 將擁有該 TableAttribute 屬性的類別視為持久類別。
LINQ 轉 SQL 僅支援單表映射。 也就是說,實體類別必須精確對應到一個資料庫資料表,且不能同時將資料庫資料表映射到多個類別。
你可以利用 Name 屬性的 TableAttribute 屬性來指定資料表名稱,也可以選擇性地用結構名稱來限定資料表名稱。 若未使用 Name 屬性指定名稱,則資料表名稱與類別名稱相同。
模式限定名稱
你可以選擇性地使用結構名稱來限定資料表名稱。 預設情況下,字串中第一個句點 Name 左側的標記被視為結構名稱。 名稱的其餘部分被視為桌名。 供應商會根據情況引用桌子名稱。 例如,SQL Server 的 LINQ 轉 SQL 提供者確保括號至少在需要的地方被使用。
備註
在某些情況下,你必須明確引用屬性,因為 SQL Server 提供者無法自動引用。 下表顯示一些範例。
| 案例 | 範例:識別碼名稱 | 範例:屬性中的期望字串 | 否則...... |
|---|---|---|---|
| 結構名稱包含一個句號 | 架構:「A.B」 表格:「C」 |
「[A.B.], C" | 第一個週期假設是將結構名稱與資料表名稱分開。 |
結構/資料表名稱以 @ |
「@SomeName」 | 「[@SomeName]」 | 假設是參數名稱。 |
模式以 開頭 [ ,結束於 ] |
「[Schema.Table]」 | 「[[Schema]。[表格]]]」 | 未引號的識別碼類似於引號識別碼。 |
表格以 開頭 [ ,以 結尾 ] |
「[表格]」 | 「[[表格]]]」 | 未引號的識別碼類似於引號識別碼。 |
建構函式
| 名稱 | Description |
|---|---|
| TableAttribute() |
初始化 TableAttribute 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| Name |
取得或設定表格或視圖的名稱。 |
| TypeId |
在衍生類別中實作時,取得這個 Attribute的唯一標識碼。 (繼承來源 Attribute) |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
傳回值,這個值表示這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| GetHashCode() |
傳回這個實例的哈希碼。 (繼承來源 Attribute) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| IsDefaultAttribute() |
在衍生類別中覆寫時,指出這個實例的值是否為衍生類別的預設值。 (繼承來源 Attribute) |
| Match(Object) |
在衍生類別中覆寫時,傳回值,指出這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
擷取 物件的型別資訊,可用來取得介面的類型資訊。 (繼承來源 Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
提供物件所公開屬性和方法的存取權。 (繼承來源 Attribute) |