DataContext 方法(O/R 设计器)

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

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

方法窗格

映射到存储过程和函数的 DataContext 方法显示在 O/R 设计器的“方法”窗格中 。 “方法”窗格位于“实体”窗格(主设计图面)的旁边。 “方法”窗格列出使用 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# 中不支持的字符,将使用下划线替代空格或无效字符。