Close Method (SqlDataReader)

In This Topic

Syntax

Visual Basic
C#

'Declaration
 
Public Overrides Sub Close()

public override void Close()

Remarks

You must explicitly call the Close method after you have finished working with the SqlDataReader in order to use the associated SqlConnection for any other purpose.

Example

The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. The example reads through the data, writing it out to the console. Finally, the example closes the SqlDataReader, then the SqlConnection.

csharp

public void ReadMyData(string myConnString)
{
  string mySelectQuery = "SELECT DeptNo, DName FROM Test.Dept";
  SqlConnection myConnection = new SqlConnection(myConnString);
  SqlCommand myCommand = new SqlCommand(mySelectQuery,myConnection);
  myConnection.Open();
  SqlDataReader myReader;
  myReader = myCommand.ExecuteReader();
  // Always call Read before accessing data.
  while (myReader.Read()) {
    Console.WriteLine(myReader.GetInt32(0) + ", " + myReader.GetString(1));
  }
  // always call Close when done reading.
  myReader.Close();
  // Close the connection when done with it.
  myConnection.Close();
}

Visual Basic

Public Sub ReadMyData(myConnString As String)
  Dim mySelectQuery As String = "SELECT DeptNo, DName FROM Test.Dept"
  Dim myConnection As New SqlConnection(myConnString)
  Dim myCommand As New SqlCommand(mySelectQuery, myConnection)
  myConnection.Open()
  Dim myReader As SqlDataReader
  myReader = myCommand.ExecuteReader()
  ' Always call Read before accessing data.
  While myReader.Read()
    Console.WriteLine(myReader.GetInt32(0).ToString() + ", " _
      + myReader.GetString(1))
  End While
  ' always call Close when done reading.
  myReader.Close()
  ' Close the connection when done with it.
  myConnection.Close()
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SqlDataReader Class
SqlDataReader Members
SqlConnection Class
SqlCommand Class

Send Feedback