SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest einen Datenstrom von Zeichen aus dem angegebenen Spaltenoffset in den Puffer als Array ab dem angegebenen Pufferoffset.
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 -> int64abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParameter
- i
- Int32
Die nullbasierte Spalten-Ordnungszahl.
- dataIndex
- Int64
Der Index innerhalb des Felds, aus dem der Lesevorgang gestartet werden soll.
- buffer
- Char[]
Der Puffer, in den der Datenstrom von Bytes gelesen werden soll.
- bufferIndex
- Int32
Der Index innerhalb der Stelle, an der buffer der Schreibvorgang gestartet werden soll.
- length
- Int32
Die maximale Länge, die in den Puffer kopiert werden soll.
Gibt zurück
Die tatsächliche Anzahl der gelesenen Zeichen.
Implementiert
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 nullübergeben, der lautet, GetChars gibt die Länge des gesamten Felds in Zeichen und nicht die verbleibende Größe basierend auf dem Pufferoffsetparameter zurück.
Es werden keine Konvertierungen ausgeführt; Daher. Die abgerufenen Daten müssen bereits ein Zeichenarray sein.
Note
Die GetChars Methode gibt 0 zurück, wenn dataIndex sie negativ ist.
