SqlDataReader.Close SqlDataReader.Close SqlDataReader.Close SqlDataReader.Close Method

Определение

Закрывает объект SqlDataReader.Closes the SqlDataReader object.

public:
 override void Close();
public override void Close ();
override this.Close : unit -> unit
Public Overrides Sub Close ()

Реализации

Примеры

В следующем примере создается SqlConnection, SqlCommandи SqlDataReader.The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. В примере считываются по данным, записывая их в окне консоли.The example reads through the data, writing it out to the console window. Код затем закрывает SqlDataReader.The code then closes the SqlDataReader. SqlConnection Закрывается автоматически в конце using блок кода.The SqlConnection is closed automatically at the end of the using code block.

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();
            }
        }
    }
}
Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Комментарии

Необходимо явно вызывать Close метод после завершения работы с помощью SqlDataReader использовать связанное SqlConnection в любых других целях.You must explicitly call the Close method when you are through using the SqlDataReader to use the associated SqlConnection for any other purpose.

Close Метод заполняет значения для выходных параметров, возвращаемых значений и RecordsAffected, увеличивает время, необходимое для закрытия SqlDataReader , используемый для обработки больших или сложных запросов.The Close method fills in the values for output parameters, return values and RecordsAffected, increasing the time that it takes to close a SqlDataReader that was used to process a large or complex query. Когда возвращаемые значения и число записей, затронутых запросом не учитываются, время, необходимое для закрытия SqlDataReader можно сократить путем вызова Cancel метод связанного SqlCommand объект перед вызовом Close метод.When the return values and the number of records affected by a query are not significant, the time that it takes to close the SqlDataReader can be reduced by calling the Cancel method of the associated SqlCommand object before calling the Close method.

Внимание!

Не вызывайте Close или Dispose на подключение, DataReader или любого другого управляемого объекта в Finalize метод класса.Do not call Close or Dispose on a Connection, a DataReader, or any other managed object in the Finalize method of your class. Метод завершения освобождать только неуправляемые ресурсы, которые ваш класс непосредственно владеет.In a finalizer, you should only release unmanaged resources that your class owns directly. Если класс не владеет какими-либо неуправляемыми ресурсами, не включайте в его определение метод Finalize.If your class does not own any unmanaged resources, do not include a Finalize method in your class definition. Дополнительные сведения см. в разделе Сборка мусора.For more information, see Garbage Collection.

Применяется к

Дополнительно