SqlChars.Read(Int64, Char[], Int32, Int32) Methode

Definition

Kopiert Zeichen aus dieser SqlChars-Instanz in den übergebenen Puffer und gibt die Anzahl kopierter Zeichen zurück.Copies characters from this SqlChars instance to the passed-in buffer and returns the number of copied characters.

public:
 long Read(long offset, cli::array <char> ^ buffer, int offsetInBuffer, int count);
public long Read (long offset, char[] buffer, int offsetInBuffer, int count);
member this.Read : int64 * char[] * int * int -> int64
Public Function Read (offset As Long, buffer As Char(), offsetInBuffer As Integer, count As Integer) As Long

Parameter

offset
Int64

Ein Int64-long-Wertoffset in den Wert, der in der SqlChars-Instanz enthalten ist.An Int64long value offset into the value that is contained in the SqlChars instance.

buffer
Char[]

Der Zeichenarraypuffer, in den hineinkopiert werden soll.The character array buffer to copy into.

offsetInBuffer
Int32

Ein Int32-Ganzzahloffset in den Puffer, in den das Kopieren gestartet werden soll.An Int32 integer offset into the buffer to start copying into.

count
Int32

Ein Int32-Ganzzahlwert, der die Anzahl der zu kopierenden Zeichen darstellt.An Int32 integer value representing the number of characters to copy.

Gibt zurück

Int64

Ein Int64-long-Wert, der die Anzahl der kopierten Bytes darstellt.An Int64long value representing the number of copied bytes.

Hinweise

Wenn versucht wird, darüber hinaus zu lesen MaxLength , wird eine Ausnahme ausgelöst.If an attempt is made to read beyond MaxLength, an exception is thrown.

Wenn count mehr Zeichen angibt, die kopiert werden sollen, als von offsetInBuffer bis zum Ende des Werts verfügbar sind, werden nur die verfügbaren Zeichen kopiert.If count specifies more characters to be copied than are available from the offsetInBuffer to the end of the value, only the available characters are copied.

Eine Ausnahme wird ausgelöst, wenn der Ziel Puffer ein NULL-Verweis ist.An exception is thrown if the destination buffer is a null reference.

Eine Ausnahme wird ausgelöst, wenn der Ziel Puffer nicht so viele Zeichen wie angefordert empfangen kann.An exception is thrown if the destination buffer cannot receive as many characters as requested.

Gilt für:

Weitere Informationen