SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Methode

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Liest einen Datenstrom von Zeichen ab dem angegebenen Pufferoffset als Array aus dem angegebenen Spaltenoffset in den Puffer ab.

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parameter

i
Int32

Die nullbasierte Ordnungszahl der Spalte.

dataIndex
Int64

Der Index innerhalb des Felds, an dem der Lesevorgang gestartet werden soll.

buffer
Char[]

Der Puffer, in den der Bytedatenstrom gelesen werden soll.

bufferIndex
Int32

Der Index im buffer, an dem der Schreibvorgang beginnen soll.

length
Int32

Die maximale Länge, die in den Puffer kopiert werden soll.

Gibt zurück

Int64

Die tatsächlich gelesene Anzahl von Zeichen.

Implementiert

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

Hinweise

GetChars gibt die Anzahl der verfügbaren Zeichen im Feld zurück. Häufig ist dies die genaue Länge des Felds. Die zurückgegebene Zahl kann jedoch kleiner als die tatsächliche Länge des Felds sein, wenn GetChars bereits zum Abrufen von Zeichen aus dem Feld verwendet wurde. Dies kann beispielsweise der Fall sein, wenn eine SqlDataReader große Datenstruktur in einen Puffer gelesen wird. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.

Die tatsächliche Anzahl der gelesenen Zeichen kann kleiner als die angeforderte Länge sein, wenn das Ende des Felds erreicht ist. Wenn Sie einen Puffer übergeben, GetChars gibt nulldie Länge des gesamten Felds in Zeichen und nicht die verbleibende Größe basierend auf dem Pufferoffsetparameter zurück.

Es werden keine Konvertierungen durchgeführt. Daher. Die abgerufenen Daten müssen bereits ein Zeichenarray sein.

Hinweis

Die GetChars Methode gibt 0 zurück, wenn dataIndex negativ ist.

Gilt für:

Weitere Informationen