SqlDataReader类使用

可以用SqlDataReader类对象从SQL Server数据库中读取行

DataReader对象允许你以向前的,只读的方式读取数据,有时候DataReader对象也称为消软管游标。DataReader对象采用了一种简化的数据读取方式,但是提高了性能的同时也牺牲了很多特性。例如在DataSet中支持的排序,分页等功能。这些功能将在以后的章节进行详细的介绍。 

SqlDataReader的属性 

属性 说明 
Depth  其返回类型为int,取得表示当前行嵌入深度的值 
FieldCount  其返回类型为int,取得当前行的列数 
IsColsed  其返回类型为bool,取得一个布尔值,表示是否关闭数据读取 
RecordsAffected  其返回类型为int, 取得执行SQL语句增加、修改或删除的行数。 

SqlDataReader的方法 

方法  说明 
Reader() 其返回类型为bool,将数据阅读器移到结果集的下一行并读取该行。这个方法返回的布尔值表示结果集中是否有多行 
GetValue()  其返回类型为object, 返回指定列的值 
GetValues()  其返回类型为int,将当前行中所有列的值复制到指定对象数组。这个方法返回的int是数组元素的个数 
NextResult()  其返回类型为bool,将数据阅读器移到结果集的下一行。这个方法返回的布尔值表示结果集中是否有多行 
Close() 关闭 SqlDataReader 对象 
GetInt32(),GetChar(), 
GateDataTime(),Get×××()  返回指定列的值,并且返回的类型为相应的数据类型。例如GetInt32()返回整型的数值。注意,如果你将返回值赋予一个类型不匹配的变量时,将会抛出一个InvalidCastException异常 

 用ExecuteReader()方法执行查询 

  下面是一个用ExecuteReader()方法执行SELECT语句的范例。这个方法用DataReader对象返回结果集,然后可以用此对象读取数据库返回的行。 

范例程序代码如下: 

01 public partial class _Default : System.Web.UI.Page 
 02 { 
 03 protected void Page_Load(object sender, EventArgs e) 
 04 { 
 05 string connectionString = 
 06 ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 
 07 SqlConnection con = new SqlConnection(connectionString); 
 08 string sql = "SELECT top 5 CustomerID,CompanyName,ContactName,Address 
 09 FROM Customers"; 
 10 SqlCommand cmd = new SqlCommand(sql, con); 
 11 con.Open(); 
 12 SqlDataReader reader = cmd.ExecuteReader(); 
 13 StringBuilder htmlStr = new StringBuilder(""); 
 14 while (reader.Read()) 
 15 { 
 16 htmlStr.Append("CustomerID:" + reader["CustomerID"] + "<br>"); 
 17 htmlStr.Append("CompanyName:" + reader["CompanyName"] + "<br>"); 
 18 htmlStr.Append("ContactName:" + reader.GetString(2) + "<br>"); 
 19 htmlStr.Append("Address:" + reader.GetString(3) + "<br>"); 
 20 htmlStr.Append("<hr>"); 
 21 } 
 22 reader.Close(); 
 23 con.Close(); 
 24 HtmlContent.Text = htmlStr.ToString(); 
 25 } 
 26 }



  程序代码说明:在上述语法范例的程序代码中,第5到12行代码生成所要的对象并执行SELECT语句,从 Customers表中读取前5条记录。cmd返回的结果集存放在reader对象中,然后你可以用Reader()方法读取reader对象的记录。这个方法在有另一个可读的行时返回布尔真值,否则返回布尔假值。可以从reader对象中读取一个记录的各个列值,只要在方括号中传入列名即可。如第16和 17行所示,我们用reader[“CustomerID”]读取CustomerID列的各项内容。你也可以直接在方括号中传入数字值指定想要列的索引。如第18和19行代码所显示,由于我们在用SELECT进行数据查询的时,ContactName和Address分别位于第3和第4列,而相应的索引值则为2和3,所以我们可以用reader.GetString(2)和reader.GetString(3)读取ContactName和 Address列的数据。如第14行代码所示,我们可以在While循环中用Reader()方法一一读取每条记录。 

每次程序执行命令时,都要将相应的命令通过网络传递到数据库中,并在数据库进行执行,然后将结果返回到程序中,从而产生大量的网络通信流。我们可以使用ExecuteReader()方法同时执行多条SELECT语句查询减少重复的数据传递。 

  下面的实例是使用ExecuteReader()方法同时查询三个表中的数据,并将返回的三个结果集显示在页面上。 

  范例程序代码如下: 

01 public partial class _Default : System.Web.UI.Page 
 02 { 
 03 protected void Page_Load(object sender, EventArgs e) 
 04 { 
 05 string connectionString = 
 06 ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 
 07 SqlConnection con = new SqlConnection(connectionString); 
 08 SqlCommand cmd = con.CreateCommand(); 
 09 cmd.CommandText = "SELECT TOP 3 ProductID,ProductName 
 10 FROM Products ORDER BY ProductID;" + 
 11 "SELECT TOP 3 CustomerID,CompanyName 
 12 FROM Customers ORDER BY CustomerID;" + 
 13 "SELECT TOP 3 OrderID,CustomerID 
 14 FROM Orders ORDER BY OrderID;"; 
 15 con.Open(); 
 16 SqlDataReader reader = cmd.ExecuteReader(); 
 17 StringBuilder htmStr=new StringBuilder(""); 
 18 int i = 0; 
 19 do 
 20 { 
 21 htmStr.Append("结果集"); 
 22 htmStr.Append(i.ToString()); 
 23 htmStr.Append("<br>"); 
 24 while (reader.Read()) 
 25 { 
 26 htmStr.Append("reader[0]=" + reader[0]); 
 27 htmStr.Append("<br>"); 
 28 htmStr.Append("reader[1]=" + reader[1]); 
 29 htmStr.Append("<br><br>"); 
 30 } 
 31 htmStr.Append("<hr>"); 
 32 i++; 
 33 } while (reader.NextResult()); 
 34 reader.Close(); 
 35 con.Close(); 
 36 HtmlContent.Text = htmStr.ToString(); 
 37 } 
 38 }



  程序代码说明:在上述语法范例的程序代码中,第9行到第14中定义了3个查询语句,各语句之间用分号进行间隔。第16行调用ExecuteReader()方法,并返回SqlDataReader对象,并且对三条不同的SELECT语句各返回一个结果集。要读取第一个结果集的话,可以用SqlDataReader对象的Reader()方法。Reader()方法在没有其他的可读行时将返回一个false 值。当一个结果集的所有记录都读取完毕后,可以调用SqlDataReader对象的NextResult()方法,然后在读取下一个结果集,在没有其他的结果集时,也返回一个false值。 

  提示:外循环do…while测试结尾的reader. NextResult()的返回值。由于do…while循环末尾检测这个条件,这样就保证了do…while循环至少执行一次。之所以在末尾才调用 NextResult()方法,是因为这样可以首先把SqlDataReader对象移到下一个结果集,然后才返回表示是否还有下一个结果集的布尔结果。如果使用while循环中,则有可能直接跳过第一个结果集,从而产生错误。