SqlCommand.ExecuteReader Metoda

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v1.0.19269.1

Pakiet:: Microsoft.Data.SqlClient v1.1.4

Pakiet:: Microsoft.Data.SqlClient v2.0.1

Pakiet:: Microsoft.Data.SqlClient v2.1.4

Pakiet:: Microsoft.Data.SqlClient v3.0.1

Pakiet:: Microsoft.Data.SqlClient v3.1.0

Pakiet:: Microsoft.Data.SqlClient v4.0.1

Pakiet:: Microsoft.Data.SqlClient v4.1.0

Pakiet:: Microsoft.Data.SqlClient v5.0.0

Pakiet:: Microsoft.Data.SqlClient v5.1.0

Pakiet:: Microsoft.Data.SqlClient v5.2.0

Pakiet:: Microsoft.Data.SqlClient v6.0.2

Pakiet:: Microsoft.Data.SqlClient v6.1.3

Pakiet:: Microsoft.Data.SqlClient v7.0.1

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Nazwa	Opis
ExecuteReader()	Wysyła element CommandText do pliku Connection i tworzy element SqlDataReader.
ExecuteReader(CommandBehavior)	Wysyła element CommandText do elementu Connectioni tworzy obiekt SqlDataReader przy użyciu jednej z CommandBehavior wartości.

ExecuteReader()

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Wysyła element CommandText do pliku Connection i tworzy element SqlDataReader.

public:
 Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader();

public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader();

override this.ExecuteReader : unit -> Microsoft.Data.SqlClient.SqlDataReader

Public Function ExecuteReader () As SqlDataReader

Zwraca

SqlDataReader

Obiekt SqlDataReader.

Wyjątki

InvalidCastException

Inny SqlDbType niż Binary lub VarBinary był używany, gdy Value ustawiono wartość Stream. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.
Inny SqlDbType niż Char, , NCharNVarChar, VarCharlub Xml został użyty, gdy Value został ustawiony na TextReader.
Inny SqlDbType niż Xml był używany, gdy Value został ustawiony na XmlReaderwartość .

SqlException

Wystąpił wyjątek podczas wykonywania polecenia względem zablokowanego wiersza. Ten wyjątek nie jest generowany w przypadku korzystania z programu Microsoft .NET Framework w wersji 1.0.
Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

InvalidOperationException

Bieżący stan połączenia jest zamknięty. ExecuteReader() wymaga otwartego SqlConnectionpliku .
Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

Wystąpił błąd w Stream XmlReader obiekcie lub TextReader podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Stream Obiekt XmlReaderlub TextReader został zamknięty podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

Przykłady

Poniższy przykład tworzy element SqlCommand, a następnie wykonuje go, przekazując ciąg, który jest instrukcją Transact-SQL SELECT, i ciągiem używanym do nawiązywania połączenia ze źródłem danych.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
        CreateCommand(qs, str);
    }

    private static void CreateCommand(string queryString,
        string connectionString)
    {
        using (SqlConnection connection = new SqlConnection(
                   connectionString))
        {
            connection.Open();

            SqlCommand command = new SqlCommand(queryString, connection);
            SqlDataReader reader = command.ExecuteReader();
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }

Uwagi

CommandType Gdy właściwość jest ustawiona na StoredProcedure, CommandText właściwość powinna być ustawiona na nazwę procedury składowanej. Polecenie wykonuje tę procedurę składowaną podczas wywoływania metody ExecuteReader.

Uwaga / Notatka

Jeśli transakcja zostanie zakleszona, wyjątek może nie zostać zgłoszony do momentu Read wywołania.

Funkcja wielu aktywnych zestawów wyników (MARS) umożliwia wykonywanie wielu akcji przy użyciu tego samego połączenia.

Jeśli używasz ExecuteReader danych XML lub BeginExecuteReader uzyskujesz do nich dostęp, program SQL Server zwróci wszystkie wyniki XML większe niż 2033 znaki w wielu wierszach o długości 2033 znaków. Aby uniknąć tego zachowania, użyj polecenia ExecuteXmlReader lub BeginExecuteXmlReader do odczytu zapytań XML.

Dotyczy

ExecuteReader(CommandBehavior)

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Źródło:: SqlCommand.cs

Wysyła element CommandText do elementu Connectioni tworzy obiekt SqlDataReader przy użyciu jednej z CommandBehavior wartości.

public:
 Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader(System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> Microsoft.Data.SqlClient.SqlDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

Parametry

behavior: CommandBehavior

CommandBehavior Jedna z wartości.

Zwraca

SqlDataReader

Obiekt SqlDataReader.

Wyjątki

InvalidCastException

SqlException

Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

InvalidOperationException

Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Przykłady

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
        CreateCommand(qs, str);
    }

    private static void CreateCommand(string queryString,
        string connectionString)
    {
        using (SqlConnection connection = new SqlConnection(
                   connectionString))
        {
            SqlCommand command = new SqlCommand(queryString, connection);
            connection.Open();
            SqlDataReader reader =
                command.ExecuteReader(CommandBehavior.CloseConnection);
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Uwagi

Uwaga / Notatka

Służy SequentialAccess do pobierania dużych wartości i danych binarnych. W przeciwnym razie może dojść do OutOfMemoryException i połączenie zostanie zamknięte.

Funkcja wielu aktywnych zestawów wyników (MARS) umożliwia wykonywanie wielu akcji przy użyciu tego samego połączenia.

Dotyczy