基于属性的映射 (LINQ to SQL)

更新：November 2007

LINQ to SQL 通过应用属性或通过使用外部映射文件将 SQL Server 数据库映射到 LINQ to SQL 对象模型。本主题概述了基于属性的方法。

LINQ to SQL 最基本的映射形式是将数据库映射到 DataContext，将表映射到类，将列和关系映射到这些类的属性。您也可以使用属性来将继承层次结构映射到对象模型中。有关更多信息，请参见 如何：使用 Visual Basic 或 C# 生成对象模型 (LINQ to SQL)。

使用 Visual Studio 的开发人员通常会使用 对象关系设计器 来执行基于属性的映射。对象关系设计器（O/R 设计器）
对象关系设计器（O/R 设计器）
对象关系设计器（O/R 设计器） 您还可以使用 SQLMetal 命令行工具，或自行手动编写这些属性的代码。有关更多信息，请参见 如何：使用 Visual Basic 或 C# 生成对象模型 (LINQ to SQL)。

说明：
您还可以通过使用外部 XML 文件进行映射。有关更多信息，请参见外部映射引用 (LINQ to SQL)。

以下各节更加详细地介绍了基于属性的映射。有关更多信息，请参见 System.Data.Linq.Mapping 命名空间。

DatabaseAttribute 属性

使用此属性可指定在连接未提供名称时数据库的默认名称。此属性 (Attribute) 是可选的，但如果使用它，则必须按照下表中的说明应用 Name 属性 (Property)。

属性	类型	默认值	说明
Name	字符串	请参见 Name	与其 Name 属性一起使用，用于指定数据库的名称。

有关更多信息，请参见 DatabaseAttribute。

TableAttribute 属性

使用此属性可将类指定为与数据库表或视图关联的实体类。LINQ to SQL 将具有此属性的类视为持久性类。下表介绍了 Name 属性。

属性	类型	默认值	说明
Name	字符串	与类名相同的字符串	将类指定为与数据库表关联的实体类。

有关更多信息，请参见 TableAttribute。

ColumnAttribute 属性

使用此属性可指定实体类的某个成员表示数据库表中的列。您可以将此属性 (Attribute) 应用于任何字段或属性 (Property)。

当 LINQ to SQL 保存对数据库所做的更改时，只会检索并持久保存您标识为列的那些成员。不具有此属性的成员被假定为非持久的，且不会被提交以进行插入或更新。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
AutoSync	AutoSync	Never	指示公共语言运行库 (CLR) 在执行插入或更新操作后检索值。 可供选择的值：Always、Never、OnUpdate、OnInsert。
CanBeNull	布尔值	true	指示列可以包含 null 值。
DbType	字符串	推断出的数据库列类型	使用数据库类型和修饰符来指定数据库列的类型。
Expression	字符串	空	定义数据库中计算所得的列。
IsDbGenerated	布尔值	false	指示列包含数据库自动生成的值。
IsDiscriminator	布尔值	false	指示列包含 LINQ to SQL 继承层次结构的鉴别器值。
IsPrimaryKey	布尔值	false	指定此类成员表示作为表主键或表主键一部分的列。
IsVersion	布尔值	false	将成员的列类型标识为数据库时间戳或版本号。
UpdateCheck	UpdateCheck	除非对某个成员而言 IsVersion 为 true，否则为 Always	指定 LINQ to SQL 如何实现开放式并发冲突的检测。

有关更多信息，请参见 ColumnAttribute。

说明：
AssociationAttribute 和 ColumnAttribute Storage 属性值区分大小写。例如，请确保 AssociationAttribute.Storage 属性 (Property) 的属性 (Attribute) 中使用的值与代码中其他位置使用的相应属性 (Property) 名称值的大小写相匹配。这适用于所有 .NET 编程语言，即使是那些通常不区分大小写的编程语言，包括 Visual Basic。有关 Storage 属性的更多信息，请参见 DataAttribute.Storage。

AssociationAttribute 属性

使用此属性 (Attribute) 可指定属性 (Property) 表示数据库中的关联，如外键对主键关系。有关关系的更多信息，请参见 如何：映射数据库关系 (LINQ to SQL)。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
DeleteOnNull	布尔值	false	当放置在其外键成员均不可以为 null 的关联上时，如果该关联设置为 null，则删除对象。
DeleteRule	字符串	无	向关联添加删除行为。
IsForeignKey	布尔值	false	如果为 true，则将成员指定为表示数据库关系的关联中的外键。
IsUnique	布尔值	false	如果为 true，则指示对外键的唯一性约束。
OtherKey	字符串	相关类的 ID	将目标实体类的一个或多个成员指定为关联的另一端上的键值。
ThisKey	字符串	包含类的 ID	指定此实体类的成员表示关联的此端上的键值。

有关更多信息，请参见 AssociationAttribute。

说明：
AssociationAttribute 和 ColumnAttribute Storage 属性值区分大小写。例如，请确保 AssociationAttribute.Storage 属性 (Property) 的属性 (Attribute) 中使用的值与代码中其他位置使用的相应属性 (Property) 名称值的大小写相匹配。这适用于所有 .NET 编程语言，即使是那些通常不区分大小写的编程语言，包括 Visual Basic。有关 Storage 属性的更多信息，请参见 DataAttribute.Storage。

InheritanceMappingAttribute 属性

使用此属性可映射继承层次结构。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
Code	字符串	无。必须提供值。	指定鉴别器的代码值。
IsDefault	布尔值	false	如果为 true，则在存储区中没有与指定值中的任何一个值匹配的鉴别器值时实例化此类型的对象。
Type	类型	无。必须提供值。	指定层次结构中的类的类型。

有关更多信息，请参见 InheritanceMappingAttribute。

FunctionAttribute 属性

使用此属性可指定方法表示数据库中的存储过程或用户定义函数。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
IsComposable	布尔值	false	如果为 false，则指示映射到存储过程。如果为 true，则指示映射到用户定义的函数。
Name	字符串	与数据库中的名称相同的字符串	指定存储过程或用户定义函数的名称。

有关更多信息，请参见 FunctionAttribute。

ParameterAttribute 属性

使用此属性可映射存储过程方法中的输入参数。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
DbType	字符串	无	指定数据库类型。
Name	字符串	与数据库中的参数名相同的字符串	指定参数的名称。

有关更多信息，请参见 ParameterAttribute。

ResultTypeAttribute 属性

使用此属性可指定结果类型。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
Type	类型	（无）	用于映射到返回 IMultipleResults 的存储过程的方法。为存储过程声明有效的或预期的类型映射。

有关更多信息，请参见 ResultTypeAttribute。

DataAttribute 属性

使用此属性可指定名称和私有存储字段。

下表介绍了此属性 (Attribute) 的属性 (Property)。

属性	类型	默认值	说明
Name	字符串	与数据库中的名称相同	指定表、列等的名称。
Storage	字符串	公共访问器	指定基础存储字段的名称。

有关更多信息，请参见 DataAttribute。

请参见

其他资源

参考 (LINQ to SQL)