SqlCommand.ExecuteReader Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| ExecuteReader() |
Envoie le CommandText fichier à l’objet Connection et génère un SqlDataReader. |
| ExecuteReader(CommandBehavior) |
Envoie la CommandText valeur à l’objet Connection, et génère une SqlDataReader à l’aide de l’une CommandBehavior des valeurs. |
ExecuteReader()
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
Envoie le CommandText fichier à l’objet Connection et génère un SqlDataReader.
public:
Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader();public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader();override this.ExecuteReader : unit -> Microsoft.Data.SqlClient.SqlDataReaderPublic Function ExecuteReader () As SqlDataReaderRetours
Objet SqlDataReader.
Exceptions
-
Un SqlDbType autre que
BinaryouVarBinarya été utilisé quand Value a été défini sur Stream. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient. -
Autre SqlDbType que
Char, ,NChar,NVarChar,VarCharouXmla été utilisé quand Value a été défini sur TextReader. -
Un SqlDbType autre que
Xmlcelui utilisé lors Value de l’utilisation a été défini sur XmlReader.
- Une exception s’est produite lors de l’exécution de la commande sur une ligne verrouillée. Cette exception n’est pas générée lorsque vous utilisez Microsoft .NET Framework version 1.0.
- Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
- L’état actuel de la connexion est fermé. ExecuteReader() nécessite une ouverture SqlConnection.
- SqlConnection Fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Une erreur s’est produite dans un objet ou StreamXmlReader un TextReaderobjet pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
L’objet ou Stream l’objet XmlReaderTextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Exemples
L’exemple suivant crée un SqlCommand, puis l’exécute en passant une chaîne qui est une instruction SELECT Transact-SQL et une chaîne à utiliser pour se connecter à la source de données.
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]));
}
}
}
Remarques
Lorsque la CommandType propriété est définie StoredProceduresur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.
Note
Si une transaction est bloquée, une exception peut ne pas être levée tant qu’elle Read n’est pas appelée.
La fonctionnalité MARS (Multiple Active Result Set) permet plusieurs actions à l’aide de la même connexion.
Si vous utilisez ExecuteReader ou BeginExecuteReader pour accéder aux données XML, SQL Server retourne tous les résultats XML supérieurs à 2 033 caractères de longueur dans plusieurs lignes de 2 033 caractères chacun. Pour éviter ce comportement, utilisez ExecuteXmlReader ou BeginExecuteXmlReader lisez des requêtes FOR XML.
S’applique à
ExecuteReader(CommandBehavior)
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
- Source:
- SqlCommand.cs
Envoie la CommandText valeur à l’objet Connection, et génère une SqlDataReader à l’aide de l’une CommandBehavior des valeurs.
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 SqlDataReaderParamètres
- behavior
- CommandBehavior
Une des CommandBehavior valeurs.
Retours
Objet SqlDataReader.
Exceptions
Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Une erreur s’est produite dans un objet ou StreamXmlReader un TextReaderobjet pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
SqlConnection Fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
L’objet ou Stream l’objet XmlReaderTextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Exemples
L’exemple suivant crée un SqlCommand, puis l’exécute en passant une chaîne qui est une instruction SELECT Transact-SQL et une chaîne à utiliser pour se connecter à la source de données. CommandBehavior a la valeur 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]));
}
}
}
}
Remarques
Lorsque la CommandType propriété est définie StoredProceduresur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.
Note
Permet SequentialAccess de récupérer des valeurs volumineuses et des données binaires. Sinon, un OutOfMemoryException pourrait se produire et la connexion sera fermée.
La fonctionnalité MARS (Multiple Active Result Set) permet plusieurs actions à l’aide de la même connexion.
Si vous utilisez ExecuteReader ou BeginExecuteReader pour accéder aux données XML, SQL Server retourne tous les résultats XML supérieurs à 2 033 caractères de longueur dans plusieurs lignes de 2 033 caractères chacun. Pour éviter ce comportement, utilisez ExecuteXmlReader ou BeginExecuteXmlReader lisez des requêtes FOR XML.