SqlBytes.Read(Int64, Byte[], Int32, Int32) Methode

Definition

Namespace:
System.Data.SqlTypes
Assembly:
Assembly:
System.Data.Common.dll
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

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

Parameter

offset
Int64

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

buffer
Byte[]

Der Bytearraypuffer, in den kopiert werden soll.The byte 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

Eine Int32-Ganzzahl, die die Anzahl der zu kopierenden Bytes darstellt.An Int32 integer representing the number of bytes to copy.

Gibt zurück

Int64

Ein Int64-long-Wert, der die Anzahl der kopierten Bytes darstellt.An Int64 long 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 die Anzahl count der zu kopierenden Bytes angibt, die vom offset bis zum Ende des Werts verfügbar sind, werden nur die verfügbaren Bytes kopiert.If count specifies more bytes to be copied than are available from the offset to the end of the value, only the available bytes 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:

Siehe auch