DataContext 方法 (O/R 设计器)

DataContext 方法(在 Visual Studio 中 LINQ to SQL 工具的上下文中)是在数据库中运行存储过程和函数的 DataContext 类的方法。

DataContext 类是 LINQ to SQL 类,充当 SQL Server 数据库与映射到该数据库的 LINQ to SQL 实体类之间的管道。 该 DataContext 类包含连接字符串信息,以及用于连接到数据库和操作数据库中数据的方法。 默认情况下,该 DataContext 类包含多个可以调用的方法,例如 SubmitChanges 将更新数据从 LINQ 发送到 SQL 类的方法发送到数据库。 还可以创建映射到存储过程和函数的其他 DataContext 方法。 换句话说,调用这些自定义方法会在数据库中运行与该 DataContext 方法映射的存储过程或函数。 可以向类添加新方法 DataContext ,就像添加方法以扩展任何类一样。 在关于DataContext方法的讨论中(尤其是在O/R 设计器的上下文),重点是那些映射到存储过程和函数的DataContext方法。

“方法”窗格

DataContext映射到存储过程和函数的方法显示在 O/R 设计器的方法窗格中。 “ 方法 ”窗格是“ 实体 ”窗格(主设计图面)一侧的窗格。 “方法”窗格列出使用 DataContext创建的所有方法。 默认情况下, “方法 ”窗格为空;将存储过程或函数从 服务器资源管理器数据库资源管理器 拖到 O/R 设计器 上,以创建 DataContext 方法和填充 “方法 ”窗格。 有关详细信息,请参阅如何:创建映射到存储过程和函数的 DataContext 方法(O/R 设计器)。

注释

右键单击 O/R 设计器 ,然后单击“ 隐藏方法”窗格“显示方法”窗格,或使用键盘快捷方式 Ctrl+1,打开并关闭方法窗格。

两种类型的 DataContext 方法

DataContext 方法是映射到数据库中存储过程和函数的方法。 可以在 O/R 设计器“方法”窗格中创建和添加 DataContext 方法。 有两种不同的 DataContext 方法类型;这些方法返回一个或多个结果集,以及不返回以下结果集的方法:

返回 DataContext 方法的类型

将存储过程和函数从 服务器资源管理器数据库资源管理器 拖到 O/R 设计器上时,生成的 DataContext 方法的返回类型因放置项的位置而异。 将项直接拖放到现有实体类上将创建一个 DataContext 具有实体类返回类型的方法;将项拖放到 O/R 设计器 的空区域(在任一窗格中)将创建一个 DataContext 返回自动生成类型的方法。 自动生成的类型具有与存储过程或函数名称和属性匹配的名称,这些名称映射到存储过程或函数返回的字段。

注释

将方法添加到方法窗格后,可以更改方法的 DataContext 返回类型。 若要检查或更改方法的DataContext返回类型,请选择该方法并在“属性”窗口中检查“返回类型”属性。 有关详细信息,请参阅 “如何:更改 DataContext 方法(O/R 设计器)的返回类型”。

从数据库拖动到 O/R 设计器图面上的对象将根据数据库中的对象的名称自动命名。 如果多次拖动同一对象,则会在新名称的末尾添加一个数字,以区分名称。 当数据库对象名称包含 Visual Basic 或 C# 中不支持的空格或字符时,空格或无效字符将替换为下划线。