IDbCommand.ExecuteReader Method

Definition

Führt den CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

Overloads

ExecuteReader()

Führt den CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior)

Führt den CommandText für die Connection aus und erstellt einen IDataReader mithilfe eines der CommandBehavior-Werte.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteReader()

Führt den CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

public:
 System::Data::IDataReader ^ ExecuteReader();
public System.Data.IDataReader ExecuteReader ();
abstract member ExecuteReader : unit -> System.Data.IDataReader
Public Function ExecuteReader () As IDataReader

Returns

IDataReader

Ein IDataReader-Objekt.An IDataReader object.

ExecuteReader(CommandBehavior)

Führt den CommandText für die Connection aus und erstellt einen IDataReader mithilfe eines der CommandBehavior-Werte.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

public:
 System::Data::IDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.IDataReader ExecuteReader (System.Data.CommandBehavior behavior);
abstract member ExecuteReader : System.Data.CommandBehavior -> System.Data.IDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As IDataReader

Parameters

behavior
CommandBehavior

Einer der CommandBehavior-Werte.One of the CommandBehavior values.

Returns

IDataReader

Ein IDataReader-Objekt.An IDataReader object.

Remarks

Der Aufrufer muss die Open-Methode der Connection-Eigenschaft aufzurufen.The caller must call the Open method of the Connection property.

Wenn die CommandType-Eigenschaft auf StoredProcedurefestgelegt ist, sollte die Eigenschaft CommandText auf den Namen der gespeicherten Prozedur festgelegt werden.When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie ExecuteReaderaufgerufen haben.The command executes this stored procedure when you call ExecuteReader.

Note

Verwenden Sie SequentialAccess, um große Werte und Binärdaten abzurufen.Use SequentialAccess to retrieve large values and binary data. Andernfalls kann eine OutOfMemoryException auftreten, und die Verbindung wird geschlossen.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

Während der IDataReader verwendet wird, ist die zugeordnete IDbConnection für die IDataReaderausgelastet.While the IDataReader is in use, the associated IDbConnection is busy serving the IDataReader. In diesem Zustand können keine anderen Vorgänge für die IDbConnection durchgeführt werden, die nicht geschlossen werden.While in this state, no other operations can be performed on the IDbConnection other than closing it. Dies ist der Fall, bis die Close-Methode des DataReader aufgerufen wird.This is the case until the Close method of the DataReader is called. Wenn DataReader erstellt wird und CommandBehavior auf CloseConnectionfestgelegt ist, wird die Verbindung durch Schließen des DataReader automatisch geschlossen.If the DataReader is created with CommandBehavior set to CloseConnection, closing the DataReader closes the connection automatically.

Applies to