SqlDataReader.Close 方法

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

关闭 SqlDataReader 对象。

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

实现

Close()

示例

以下示例创建 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))
        {
            connection.Open();

            using (SqlCommand command =
                new SqlCommand(queryString, connection))
            {
                using (SqlDataReader reader = command.ExecuteReader())
                {
                    // Call Read before accessing data.
                    while (reader.Read())
                    {
                        Console.WriteLine(String.Format("{0}, {1}",
                            reader[0], reader[1]));
                    }

                    // Call Close when done reading.
                    reader.Close();
                }
            }
        }
    }
}

注解

必须确保 Close 在使用 时调用 方法， SqlDataReader 然后再将关联的 SqlConnection 用于任何其他目的。 方法 Close 可以直接调用，也可以通过 Dispose 方法调用，直接释放或在 using 语句 块的上下文中释放。

方法 Close 通过使用任何挂起的结果来填充 输出参数的值、返回值 和 RecordsAffectedSqlDataReader 。 这可能是一个长时间的操作，具体取决于要使用的数据量。 如果输出值、返回值 和 RecordsAffected 对应用程序不重要，则通过在调用 方法之前Close调用Cancel关联SqlCommand对象的 方法，可以缩短关闭时间。

注意

不要在 类的 方法中的 Finalize Connection、DataReader 或任何其他托管对象上调用 Close 或 Dispose 。 在终结器中，应仅释放类直接拥有的非托管资源。 如果类不拥有任何非托管资源，则不要在类定义中包含 Finalize 方法。 有关详细信息，请参阅垃圾回收。