SqlDataReader.Close メソッド

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.dll

SqlDataReader オブジェクトを閉じます。

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

実装

Close()

例

次の例では、 SqlConnection、 SqlCommand、および SqlDataReaderを作成します。 この例では、データを読み取り、コンソール ウィンドウに書き出します。 その後、コードは SqlDataReaderを閉じます。 SqlConnectionは、using コード ブロックの末尾で自動的に閉じられます。

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 メソッドを明示的に呼び出す必要があります。

Close メソッドは、出力パラメーター、戻り値、RecordsAffectedの値を入力し、大規模または複雑なクエリの処理に使用されたSqlDataReaderを閉じるのにかかる時間を長くします。 戻り値とクエリの影響を受けるレコードの数が大きくない場合、SqlDataReader メソッドを呼び出す前に、関連付けられているCancel オブジェクトのSqlCommand メソッドを呼び出すことによって、Closeを閉じるのにかかる時間を短縮できます。

Caution

Connection、DataReader、またはクラスの Close メソッド内の他のマネージド オブジェクトでDisposeまたはFinalizeを呼び出さないでください。 ファイナライザーでは、クラスが直接所有するアンマネージ リソースのみを解放する必要があります。 クラスがアンマネージ リソースを所有していない場合は、クラス定義に Finalize メソッドを含めないでください。 詳しくは、「ガベージ コレクション」をご覧ください。

適用対象

こちらもご覧ください