SqlDataReader.Read Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

öğesini SqlDataReader sonraki kayda ilerler.

public:
 override bool Read();

public override bool Read();

override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

Döndürülenler

Boolean

true daha fazla satır varsa; aksi takdirde false.

Uygulamalar

Read()

Özel durumlar

SqlException

SQL Server komut metnini yürütürken bir hata döndürdü.

Örnekler

Aşağıdaki örnek bir SqlConnection, SqlCommandve SqlDataReaderoluşturur. Örnek, konsol penceresine yazarak verileri okur. Kod daha sonra öğesini SqlDataReaderkapatır. SqlConnection, kod bloğunun using sonunda otomatik olarak kapatılır.

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]));
    }

}

Açıklamalar

öğesinin SqlDataReader varsayılan konumu ilk kayıttan öncedir. Bu nedenle, herhangi bir veriye erişmeye başlamak için çağrısı Read yapmanız gerekir.

Bir kerede ilişkili SqlConnection başına yalnızca bir tane SqlDataReader açık olabilir ve bir başkasını açma girişimleri ilki kapatılana kadar başarısız olur. Benzer şekilde, kullanılırkenSqlDataReader, siz çağırana Closekadar ilişkili SqlConnection onu servis etmekle meşgul olur.