Linq to Sql 学习系列之二 DataContext与实体

DataContext

 

       DataContext 类型（数据上下文）是 System.Data.Linq 命名空间下的重要类型，用于把查询句法翻译成 SQL 语句，以及把数据从数据库返回给调用方和把实体的修改写入数据库。

       DataContext 提供了以下一些使用的功能：

l         以日志形式记录 DataContext 生成的 SQL

l         执行 SQL （包括查询和更新语句）

l         创建和删除数据库

DataContext 是实体和数据库之间的桥梁，那么首先我们需要定义映射到数据表的实体。

 

定义实体类

 

 

using System.Data.Linq.Mapping;

 

[Table (Name = "Customers" )]

public class Customer

{

    [Column (IsPrimaryKey = true )]

    public string CustomerID {get ; set ;}

 

    [Column (Name = "ContactName" )]

    public string Name { get ; set ; }

 

    [Column ]

    public string City {get ; set ;}

}

       以 Northwind 数据库为例，上述 Customers 类被映射成一个表，对应数据库中的 Customers 表。然后在类型中定义了三个属性，对应表中的三个字段。其中， CustomerID 字段是主键，如果没有指定 Column 特性的 Name 属性，那么系统会把属性名作为数据表的字段名，也就是说实体类的属性名就需要和数据表中的字段名一致。

       现在，创建一个 ASP.NET 页面，然后在页面上加入一个 GridView 控件，使用下面的代码进行绑定数据：

 

using System.Data.Linq;

 

DataContext ctx = new DataContext ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

Table <Customer > Customers = ctx.GetTable<Customer >();

GridView1.DataSource = from c in Customers where c.CustomerID.StartsWith("A" ) select new { 顾客 ID=c.CustomerID, 顾客名 =c.Name, 城市 =c.City};

GridView1.DataBind();

       使用 DataContext 类型把实体类和数据库中的数据进行关联。你可以直接在 DataContext 的构造方法中定义连接字符串，也可以使用 IDbConnection ：

 

using System.Data.SqlClient;

 

IDbConnection conn = new SqlConnection ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

DataContext ctx = new DataContext (conn);

       之后，通过 GetTable 获取表示底层数据表的 Table 类型，显然，数据库中的 Customers 表的实体是 Customer 类型。随后的查询句法，即使你不懂 SQL 应该也能看明白。从 Customers 表中找出 CustomerID 以“ A ”开头的记录，并把 CustomersID 、 Name 以及 City 封装成新的匿名类型进行返回。

       结果如下图：

 

 

强类型 DataContext

 

 

public partial class NorthwindDataContext : DataContext

{

    public Table <Customer > Customers;

    public NorthwindDataContext(IDbConnection connection) : base (connection) { }

    public NorthwindDataContext(string connection) : base (connection) { }

}

       强类型数据上下文使代码更简洁：

 

NorthwindDataContext ctx = new NorthwindDataContext ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

GridView1.DataSource = from c in ctx.Customers where c.CustomerID.StartsWith("A" ) select new { 顾客 ID = c.CustomerID, 顾客名 = c.Name, 城市 = c.City };

GridView1.DataBind();

       DataContext 其实封装了很多实用的功能，下面一一介绍。

 

日志功能

 

 

using System.IO;

 

NorthwindDataContext ctx = new NorthwindDataContext ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

StreamWriter sw = new StreamWriter (Server.MapPath("log.txt" ), true ); // Append

ctx.Log = sw;

GridView1.DataSource = from c in ctx.Customers where c.CustomerID.StartsWith("A" ) select new { 顾客 ID = c.CustomerID, 顾客名 = c.Name, 城市 = c.City };

GridView1.DataBind();

sw.Close();

       运行程序后在网站所在目录生成了 log.txt ，每次查询都会把诸如下面的日志追加到文本文件中：

 

SELECT [t0].[CustomerID], [t0].[ContactName], [t0].[City]

FROM [Customers] AS [t0]

WHERE [t0].[CustomerID] LIKE @p0

-- @p0: Input String (Size = 2; Prec = 0; Scale = 0) [A%]

-- Context: SqlProvider(Sql2005) Model: AttributedMetaModel Build: 3.5.20706.1

       应该说这样的日志对于调试程序是非常有帮助的。

 

探究查询

 

 

using System.Data.Common;

using System.Collections.Generic;

 

NorthwindDataContext ctx = new NorthwindDataContext ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

var select = from c in ctx.Customers where c.CustomerID.StartsWith("A" ) select new { 顾客 ID = c.CustomerID, 顾客名 = c.Name, 城市 = c.City };

DbCommand cmd = ctx.GetCommand(select);

Response.Write(cmd.CommandText + "<br/>" );

foreach (DbParameter parm in cmd.Parameters)

    Response.Write(string .Format(" 参数名 :{0}, 参数值 :{1}<br/>" , parm.ParameterName, parm.Value));

Customer customer = ctx.Customers.First();

customer.Name = "zhuye" ;

IList <object > queryText = ctx.GetChangeSet().ModifiedEntities;

Response.Write(((Customer )queryText[0]).Name);

       在这里，我们通过 DataContext 的 GetCommand 方法获取了查询对应的 DbCommand ，并且输出了 CommandText 和所有的 DbParameter 。之后，我们又通过 GetChangeSet 方法获取了修改后的实体，并输出了修改内容。

 

执行查询

 

 

NorthwindDataContext ctx = new NorthwindDataContext ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

string newcity = "Shanghai" ;

ctx.ExecuteCommand("update Customers set City={0} where CustomerID like 'A%'" , newcity);

IEnumerable <Customer > customers = ctx.ExecuteQuery<Customer >("select * from Customers where CustomerID like 'A%'" );

GridView1.DataSource = customers;

GridView1.DataBind();

       前一篇文章已经说了，虽然 Linq to sql 能实现 90 ％以上的 TSQL 功能。但是不可否认，对于复杂的查询，使用 TSQL 能获得更好的效率。因此， DataContext 类型也提供了执行 SQL 语句的能力。代码的执行结果如下图：

 

 

创建数据库

 

 

testContext ctx = new testContext ("server=xxx;database=testdb;uid=xxx;pwd=xxx" );

ctx.CreateDatabase();

 

[Table (Name = "test" )]

public class test

{

    [Column (IsPrimaryKey = true , IsDbGenerated = true )]

    public int ID { get ; set ; }

 

    [Column (DbType="varchar(20)" )]

    public string Name { get ; set ; }

}

 

public partial class testContext : DataContext

{

    public Table <test > test;

    public testContext(string connection) : base (connection) { }

}

       这段代码在数据库中创建了名为 testdb 的数据库，等同于下面的脚本：

 

CREATE TABLE [dbo]. [test](

    [ID] [int] IDENTITY ( 1, 1) NOT NULL,

    [Name] [varchar]( 20) COLLATE Chinese_PRC_CI_AS NULL,

  CONSTRAINT [PK_test] PRIMARY KEY CLUSTERED

(

    [ID] ASC

) WITH ( IGNORE_DUP_KEY = OFF ) ON [PRIMARY]

) ON [PRIMARY]

       同时， DataContext 还提供了 DeleteDatabase() 方法，在这里就不列举了。

 

使用 DbDataReader 数据源

 

 

using System.Data.SqlClient;

 

var conn = new SqlConnection ("server=xxx;database=Northwind;uid=xxx;pwd=xxx" );

var ctx = new DataContext (conn);

var cmd = new SqlCommand ("select * from customers where CustomerID like 'A%'" , conn);

conn.Open();

var reader = cmd.ExecuteReader();       

GridView1.DataSource = ctx.Translate<Customer >(reader);

GridView1.DataBind();

conn.Close();

       你同样可以选择使用 DataReader 获取数据，增加了灵活性的同时也增加了性能。

 

看到这里，你可能会觉得手工定义和数据库中表对应的实体类很麻烦，不用担心， VS2008 提供了自动生成实体类以及关系的工具，工具的使用将在以后讲解。今天就讲到这里，和 DataContext 相关的事务、加载选项、并发选项以及关系实体等高级内容也将在以后讲解。