SqlDataReader.Read 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
让 SqlDataReader 前进到下一条记录。
public:
override bool Read();public override bool Read();override this.Read : unit -> boolPublic Overrides Function Read () As Boolean返回
如果存在更多行，则为 true；否则为 false。
实现
例外
执行命令文本时，SQL Server 返回了一个错误。
示例
以下示例创建 SqlConnection、 SqlCommand、 和 SqlDataReader。 该示例通读数据，将其写入控制台窗口。 然后，代码关闭 SqlDataReader。 在 SqlConnection 代码块末尾 using 自动关闭 。
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
string str = "Data Source=(local);Initial Catalog=Northwind;"
+ "Integrated Security=SSPI";
ReadOrderData(str);
}
private static void ReadOrderData(string connectionString)
{
string queryString =
"SELECT OrderID, CustomerID FROM dbo.Orders;";
using (SqlConnection connection =
new SqlConnection(connectionString))
{
SqlCommand command =
new SqlCommand(queryString, connection);
connection.Open();
SqlDataReader reader = command.ExecuteReader();
// Call Read before accessing data.
while (reader.Read())
{
ReadSingleRow((IDataRecord)reader);
}
// Call Close when done reading.
reader.Close();
}
}
private static void ReadSingleRow(IDataRecord record)
{
Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
}
}
注解
的默认位置 SqlDataReader 在第一条记录之前。 因此，必须调用 Read 才能开始访问任何数据。
每个关联的SqlConnection一次只能打开一SqlDataReader个，任何打开另一个的尝试都将失败，直到第一个尝试关闭。 同样，在使用 时 SqlDataReader ，关联的 SqlConnection 将忙于提供它，直到调用 Close。