SqlCommand.ExecuteReader Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| ExecuteReader() |
Invia all'oggetto CommandTextConnection e compila un oggetto SqlDataReader. |
| ExecuteReader(CommandBehavior) |
Invia all'oggetto CommandTextConnectione compila un SqlDataReader oggetto utilizzando uno dei CommandBehavior valori . |
ExecuteReader()
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
Invia all'oggetto CommandTextConnection e compila un oggetto SqlDataReader.
public:
Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader();public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader();override this.ExecuteReader : unit -> Microsoft.Data.SqlClient.SqlDataReaderPublic Function ExecuteReader () As SqlDataReaderValori restituiti
Un oggetto SqlDataReader.
Eccezioni
-
Oggetto SqlDbType diverso da
BinaryoVarBinaryutilizzato quando Value è stato impostato su Stream. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient. -
Un SqlDbType oggetto diverso da
Char,NVarCharNChar,VarChar, oXmlè stato usato quando Value è stato impostato su TextReader. -
Oggetto SqlDbType diverso da
Xmlquando è stato Value impostato su XmlReader.
- Eccezione durante l'esecuzione del comando su una riga bloccata. Questa eccezione non viene generata quando si usa Microsoft .NET Framework versione 1.0.
- Si è verificato un timeout durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
- Lo stato corrente della connessione viene chiuso. ExecuteReader() richiede un oggetto aperto SqlConnection.
- Oggetto SqlConnection chiuso o eliminato durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
Si è verificato un errore in un StreamXmlReader oggetto o TextReader durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
L'oggetto Streamo XmlReaderTextReader è stato chiuso durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
Esempio
Nell'esempio seguente viene creato un SqlCommandoggetto , che viene quindi eseguito passando una stringa che è un'istruzione SELECT Transact-SQL e una stringa da usare per connettersi all'origine dati.
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]));
}
}
}
Commenti
Quando la CommandType proprietà è impostata su StoredProcedure, la CommandText proprietà deve essere impostata sul nome della stored procedure. Il comando esegue questa stored procedure quando si chiama ExecuteReader.
Annotazioni
Se una transazione è deadlock, è possibile che non venga generata un'eccezione fino a quando Read non viene chiamato .
La funzionalità mars (Multiple Active Result Set) consente più azioni usando la stessa connessione.
Se si usa ExecuteReader o BeginExecuteReader per accedere ai dati XML, SQL Server restituirà tutti i risultati XML maggiori di 2.033 caratteri con lunghezza in più righe di 2.033 caratteri ciascuno. Per evitare questo comportamento, utilizzare ExecuteXmlReader o BeginExecuteXmlReader per leggere query FOR XML.
Si applica a
ExecuteReader(CommandBehavior)
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
- Origine:
- SqlCommand.cs
Invia all'oggetto CommandTextConnectione compila un SqlDataReader oggetto utilizzando uno dei CommandBehavior valori .
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.SqlDataReaderPublic Function ExecuteReader (behavior As CommandBehavior) As SqlDataReaderParametri
- behavior
- CommandBehavior
Uno dei CommandBehavior valori.
Valori restituiti
Un oggetto SqlDataReader.
Eccezioni
Si è verificato un timeout durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
Si è verificato un errore in un StreamXmlReader oggetto o TextReader durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
Oggetto SqlConnection chiuso o eliminato durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
L'oggetto Streamo XmlReaderTextReader è stato chiuso durante un'operazione di streaming. Per altre informazioni sullo streaming, vedere Supporto per lo streaming sqlClient.
Esempio
Nell'esempio seguente viene creato un SqlCommandoggetto , che viene quindi eseguito passando una stringa che è un'istruzione SELECT Transact-SQL e una stringa da usare per connettersi all'origine dati. CommandBehavior è impostato su CloseConnection.
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]));
}
}
}
}
Commenti
Quando la CommandType proprietà è impostata su StoredProcedure, la CommandText proprietà deve essere impostata sul nome della stored procedure. Il comando esegue questa stored procedure quando si chiama ExecuteReader.
Annotazioni
Usare SequentialAccess per recuperare valori di grandi dimensioni e dati binari. In caso contrario, potrebbe verificarsi un OutOfMemoryException e la connessione verrà chiusa.
La funzionalità mars (Multiple Active Result Set) consente più azioni usando la stessa connessione.
Se si usa ExecuteReader o BeginExecuteReader per accedere ai dati XML, SQL Server restituirà tutti i risultati XML maggiori di 2.033 caratteri con lunghezza in più righe di 2.033 caratteri ciascuno. Per evitare questo comportamento, utilizzare ExecuteXmlReader o BeginExecuteXmlReader per leggere query FOR XML.