SqlDataReader SqlDataReader SqlDataReader SqlDataReader Class

Definition

Stellt ein Verfahren zum Lesen eines Vorwärtsstreams von Zeilen aus einer SQL Server-Datenbank bereit.Provides a way of reading a forward-only stream of rows from a SQL Server database. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable
public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable
type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDisposable
    interface IDataRecord
Public Class SqlDataReader
Inherits DbDataReader
Implements IDisposable
Vererbung
Implementiert

Beispiele

Das folgende Beispiel erstellt eine SqlConnection, SqlCommand, und ein SqlDataReader.The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. Im Beispiel liest die Daten, Schreiben sie an das Konsolenfenster ausgibt.The example reads through the data, writing it out to the console window. Der Code schließt dann die SqlDataReader.The code then closes the SqlDataReader. Die SqlConnection wird automatisch geschlossen, am Ende der using Codeblock.The SqlConnection is closed automatically at the end of the using code block.

using System;
using System.Data;
using System.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]));
    }

}
Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim str As String = "Data Source=(local);Initial Catalog=Northwind;" _
       & "Integrated Security=SSPI;"
        ReadOrderData(str)
    End Sub

    Private Sub ReadOrderData(ByVal connectionString As String)
        Dim queryString As String = _
            "SELECT OrderID, CustomerID FROM dbo.Orders;"

        Using connection As New SqlConnection(connectionString)
            Dim command As New SqlCommand(queryString, connection)
            connection.Open()

            Dim reader As SqlDataReader = command.ExecuteReader()

            ' Call Read before accessing data.
            While reader.Read()
                ReadSingleRow(CType(reader, IDataRecord))
            End While

            ' Call Close when done reading.
            reader.Close()
        End Using
    End Sub

    Private Sub ReadSingleRow(ByVal record As IDataRecord)
       Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))

    End Sub

End Module

Hinweise

Zum Erstellen einer SqlDataReader, rufen Sie die ExecuteReader -Methode der der SqlCommand Objekt statt direkt einen Konstruktor.To create a SqlDataReader, you must call the ExecuteReader method of the SqlCommand object, instead of directly using a constructor.

Während der SqlDataReader verwendet wird, zugeordneten SqlConnection verarbeitet die SqlDataReader, und keine anderen Vorgänge ausgeführt werden können, auf die SqlConnection nicht schließen.While the SqlDataReader is being used, the associated SqlConnection is busy serving the SqlDataReader, and no other operations can be performed on the SqlConnection other than closing it. Dies ist der Fall, bis die Close Methode der SqlDataReader aufgerufen wird.This is the case until the Close method of the SqlDataReader is called. Beispielsweise können nicht Sie Ausgabeparameter erst abrufen, nach dem Aufruf von Close.For example, you cannot retrieve output parameters until after you call Close.

Änderungen an einem Resultset von einem anderen Prozess oder Thread während des Lesens Daten sind möglicherweise für den Benutzer sichtbar die SqlDataReader.Changes made to a result set by another process or thread while data is being read may be visible to the user of the SqlDataReader. Das genaue Verhalten ist jedoch zeitabhängig.However, the precise behavior is timing dependent.

IsClosed und RecordsAffected sind die einzigen Eigenschaften, die Sie, nachdem aufrufen können die SqlDataReader geschlossen wird.IsClosed and RecordsAffected are the only properties that you can call after the SqlDataReader is closed. Obwohl die RecordsAffected Eigenschaft zugegriffen werden kann während der SqlDataReader vorhanden ist, rufen Sie immer Close vor der Rückgabe des Werts der RecordsAffected um einen korrekten Rückgabewert zu gewährleisten.Although the RecordsAffected property may be accessed while the SqlDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Bei Verwendung von sequenziellen Zugriff (CommandBehavior.SequentialAccess), wird eine InvalidOperationException wird ausgelöst, wenn die SqlDataReader Position wird verschoben und einen anderen Vorgang wird versucht, auf die vorherige Spalte zu lesen.When using sequential access (CommandBehavior.SequentialAccess), an InvalidOperationException will be raised if the SqlDataReader position is advanced and another read operation is attempted on the previous column.

Hinweis

Um eine optimale Leistung SqlDataReader vermeidet das Erstellen nicht erforderlicher Objekte oder unnötige Kopien von Daten.For optimal performance, SqlDataReader avoids creating unnecessary objects or making unnecessary copies of data. Aus diesem Grund mehrere Aufrufe von Methoden wie z. B. GetValue einen Verweis auf das gleiche Objekt zurückzugeben.Therefore, multiple calls to methods such as GetValue return a reference to the same object. Vorsichtig, wenn Sie den zugrunde liegenden Wert wie z. B. von Methoden zurückgegebene Objekte ändern GetValue.Use caution if you are modifying the underlying value of the objects returned by methods such as GetValue.

Eigenschaften

Connection Connection Connection Connection

Ruft den SqlConnection ab, der dem SqlDataReader zugeordnet ist.Gets the SqlConnection associated with the SqlDataReader.

Depth Depth Depth Depth

Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.Gets a value that indicates the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

Ruft die Anzahl der Spalten in der aktuellen Zeile ab.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Ruft einen Wert ab, der angibt, ob SqlDataReader eine oder mehrere Zeilen enthält.Gets a value that indicates whether the SqlDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Ruft einen booleschen Wert ab, der angibt, ob die angegebene SqlDataReader-Instanz geschlossen wurde.Retrieves a Boolean value that indicates whether the specified SqlDataReader instance has been closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Ruft die Anzahl der durch die Ausführung der Transact-SQL-Anweisung geänderten, eingefügten oder gelöschten Zeilen ab.Gets the number of rows changed, inserted, or deleted by execution of the Transact-SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Ruft die Anzahl der nicht ausgeblendeten Felder im SqlDataReader ab.Gets the number of fields in the SqlDataReader that are not hidden.

Methoden

Close() Close() Close() Close()

Schließt das SqlDataReader-Objekt.Closes the SqlDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Ruft den Wert der angegebenen Spalte als ein Byte ab.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32)

Liest beginnend am angegebenen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset in den Puffer eines Arrays.Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Ruft den Wert der angegebenen Spalte als ein einzelnes Zeichen ab.Gets the value of the specified column as a single character.

GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

Liest beginnend am angegebenen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset in den Puffer eines Arrays.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetColumnSchema() GetColumnSchema() GetColumnSchema() GetColumnSchema()
GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Gibt einen IDataReader für die angegebene Spaltenordnungszahl zurück.Returns an IDataReader for the specified column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Ruft eine Zeichenfolge ab, die den Datentyp der angegebenen Spalte darstellt.Gets a string representing the data type of the specified column.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Ruft den Wert der angegebenen Spalte als DateTime-Objekt ab.Gets the value of the specified column as a DateTime object.

GetDateTimeOffset(Int32) GetDateTimeOffset(Int32) GetDateTimeOffset(Int32) GetDateTimeOffset(Int32)

Ruft den Wert der angegebenen Spalte als DateTimeOffset-Objekt ab.Retrieves the value of the specified column as a DateTimeOffset object.

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Ruft den Wert der angegebenen Spalte als Decimal-Objekt ab.Gets the value of the specified column as a Decimal object.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.Gets the value of the specified column as a double-precision floating point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen IEnumerator zurück, der SqlDataReader durchläuft.Returns an IEnumerator that iterates through the SqlDataReader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Ruft den Type ab, der den Datentyp des Objekts darstellt.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Synchronously gets the value of the specified column as a type. GetFieldValueAsync<T>(Int32, CancellationToken) ist die asynchrone Version dieser Methode.GetFieldValueAsync<T>(Int32, CancellationToken) is the asynchronous version of this method.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type. GetFieldValue<T>(Int32) ist die synchrone Version dieser Methode.GetFieldValue<T>(Int32) is the synchronous version of this method.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab.Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Ruft den Namen der angegebenen Spalte ab.Gets the name of the specified column.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Ruft ein Object ab, das eine Darstellung des Feldtyps ist, der für den zugrunde liegenden Anbieter spezifisch ist.Gets an Object that is a representation of the underlying provider-specific field type.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

Ruft ein Object ab, das eine Darstellung des Werts ist, der für den zugrunde liegenden Anbieter spezifisch ist.Gets an Object that is a representation of the underlying provider specific value.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[])

Ruft ein Array von Objekten ab, die die Werte darstellen, die für den zugrunde liegenden Anbieter spezifisch sind.Gets an array of objects that are a representation of the underlying provider specific values.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Gibt eine DataTable zurück, die die Spaltenmetadaten des SqlDataReader beschreibt.Returns a DataTable that describes the column metadata of the SqlDataReader.

GetSqlBinary(Int32) GetSqlBinary(Int32) GetSqlBinary(Int32) GetSqlBinary(Int32)

Ruft den Wert der angegebenen Spalte als SqlBinary ab.Gets the value of the specified column as a SqlBinary.

GetSqlBoolean(Int32) GetSqlBoolean(Int32) GetSqlBoolean(Int32) GetSqlBoolean(Int32)

Ruft den Wert der angegebenen Spalte als SqlBoolean ab.Gets the value of the specified column as a SqlBoolean.

GetSqlByte(Int32) GetSqlByte(Int32) GetSqlByte(Int32) GetSqlByte(Int32)

Ruft den Wert der angegebenen Spalte als SqlByte ab.Gets the value of the specified column as a SqlByte.

GetSqlBytes(Int32) GetSqlBytes(Int32) GetSqlBytes(Int32) GetSqlBytes(Int32)

Ruft den Wert der angegebenen Spalte als SqlBytes ab.Gets the value of the specified column as SqlBytes.

GetSqlChars(Int32) GetSqlChars(Int32) GetSqlChars(Int32) GetSqlChars(Int32)

Ruft den Wert der angegebenen Spalte als SqlChars ab.Gets the value of the specified column as SqlChars.

GetSqlDateTime(Int32) GetSqlDateTime(Int32) GetSqlDateTime(Int32) GetSqlDateTime(Int32)

Ruft den Wert der angegebenen Spalte als SqlDateTime ab.Gets the value of the specified column as a SqlDateTime.

GetSqlDecimal(Int32) GetSqlDecimal(Int32) GetSqlDecimal(Int32) GetSqlDecimal(Int32)

Ruft den Wert der angegebenen Spalte als SqlDecimal ab.Gets the value of the specified column as a SqlDecimal.

GetSqlDouble(Int32) GetSqlDouble(Int32) GetSqlDouble(Int32) GetSqlDouble(Int32)

Ruft den Wert der angegebenen Spalte als SqlDouble ab.Gets the value of the specified column as a SqlDouble.

GetSqlGuid(Int32) GetSqlGuid(Int32) GetSqlGuid(Int32) GetSqlGuid(Int32)

Ruft den Wert der angegebenen Spalte als SqlGuid ab.Gets the value of the specified column as a SqlGuid.

GetSqlInt16(Int32) GetSqlInt16(Int32) GetSqlInt16(Int32) GetSqlInt16(Int32)

Ruft den Wert der angegebenen Spalte als SqlInt16 ab.Gets the value of the specified column as a SqlInt16.

GetSqlInt32(Int32) GetSqlInt32(Int32) GetSqlInt32(Int32) GetSqlInt32(Int32)

Ruft den Wert der angegebenen Spalte als SqlInt32 ab.Gets the value of the specified column as a SqlInt32.

GetSqlInt64(Int32) GetSqlInt64(Int32) GetSqlInt64(Int32) GetSqlInt64(Int32)

Ruft den Wert der angegebenen Spalte als SqlInt64 ab.Gets the value of the specified column as a SqlInt64.

GetSqlMoney(Int32) GetSqlMoney(Int32) GetSqlMoney(Int32) GetSqlMoney(Int32)

Ruft den Wert der angegebenen Spalte als SqlMoney ab.Gets the value of the specified column as a SqlMoney.

GetSqlSingle(Int32) GetSqlSingle(Int32) GetSqlSingle(Int32) GetSqlSingle(Int32)

Ruft den Wert der angegebenen Spalte als SqlSingle ab.Gets the value of the specified column as a SqlSingle.

GetSqlString(Int32) GetSqlString(Int32) GetSqlString(Int32) GetSqlString(Int32)

Ruft den Wert der angegebenen Spalte als SqlString ab.Gets the value of the specified column as a SqlString.

GetSqlValue(Int32) GetSqlValue(Int32) GetSqlValue(Int32) GetSqlValue(Int32)

Gibt den Datenwert in der angegebenen Spalte als SQL Server-Typ zurück.Returns the data value in the specified column as a SQL Server type.

GetSqlValues(Object[]) GetSqlValues(Object[]) GetSqlValues(Object[]) GetSqlValues(Object[])

Füllt ein Array von Object, das die Werte aller Spalten im Datensatz als SQL Server-Typen enthält.Fills an array of Object that contains the values for all the columns in the record, expressed as SQL Server types.

GetSqlXml(Int32) GetSqlXml(Int32) GetSqlXml(Int32) GetSqlXml(Int32)

Ruft den Wert der angegebenen Spalte als XML-Wert ab.Gets the value of the specified column as an XML value.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Ruft Binary-, Varbinary-, Image-, UDT- und Variant-Datentypen als Stream ab.Retrieves binary, image, varbinary, UDT, and variant data types as a Stream.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Ruft den Wert der angegebenen Spalte als eine Zeichenfolge ab.Gets the value of the specified column as a string.

GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32)

Ruft Char-, NChar-, NText-, NVarChar-, Text-, varChar- und Variant-Datentypen als TextReader ab.Retrieves Char, NChar, NText, NVarChar, text, varChar, and Variant data types as a TextReader.

GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32)

Ruft den Wert der angegebenen Spalte als TimeSpan-Objekt ab.Retrieves the value of the specified column as a TimeSpan object.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile auf.Populates an array of objects with the column values of the current row.

GetXmlReader(Int32) GetXmlReader(Int32) GetXmlReader(Int32) GetXmlReader(Int32)

Ruft Daten vom Typ XML als XmlReader ab.Retrieves data of type XML as an XmlReader.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior)

Bestimmt, ob das angegebene CommandBehavior zu dem von SqlDataReader passt.Determines whether the specified CommandBehavior matches that of the SqlDataReader .

IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Eine asynchrone Version von IsDBNull(Int32), die einen Wert abruft, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Setzt den Datenreader beim Lesen von Transact-SQL-Batchanweisungen auf das nächste Ergebnis.Advances the data reader to the next result, when reading the results of batch Transact-SQL statements.

NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Eine asynchrone Version von NextResult(), die den Datenreader beim Lesen der Ergebnisse von Transact-SQLTransact-SQL-Batchanweisungen auf das nächste Ergebnis setzt.An asynchronous version of NextResult(), which advances the data reader to the next result, when reading the results of batch Transact-SQLTransact-SQL statements.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

Read() Read() Read() Read()

Setzt den SqlDataReader auf den nächsten Datensatz.Advances the SqlDataReader to the next record.

ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Eine asynchrone Version von Read(), die den SqlDataReader auf den nächsten Datensatz wechselt.An asynchronous version of Read(), which advances the SqlDataReader to the next record.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Gibt einen IDataReader für die angegebene Spaltenordnungszahl zurück.Returns an IDataReader for the specified column ordinal.

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Gibt alle vom Datenreader verwendeten Ressourcen frei.Releases all resources that are used by the data reader.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen Enumerator zurück, der zum Durchlaufen der Elementauflistung verwendet werden kann.Returns an enumerator that can be used to iterate through the item collection.

Gilt für:

Siehe auch