SqlBytes.Read メソッド

.NET Framework クラス ライブラリ リファレンス

SqlBytes.Read メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

この SqlBytes のインスタンスから、引数に指定されたバッファにバイトをコピーし、コピーされたバイト数を返します。

名前空間: System.Data.SqlTypes
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function Read ( _
    offset As Long, _
    buffer As Byte(), _
    offsetInBuffer As Integer, _
    count As Integer _
) As Long

Visual Basic (使用法)

Dim instance As SqlBytes
Dim offset As Long
Dim buffer As Byte()
Dim offsetInBuffer As Integer
Dim count As Integer
Dim returnValue As Long

returnValue = instance.Read(offset, buffer, offsetInBuffer, count)

C#

public long Read (
    long offset,
    byte[] buffer,
    int offsetInBuffer,
    int count
)

C++

public:
long long Read (
    long long offset, 
    array<unsigned char>^ buffer, 
    int offsetInBuffer, 
    int count
)

J#

public long Read (
    long offset, 
    byte[] buffer, 
    int offsetInBuffer, 
    int count
)

JScript

public function Read (
    offset : long, 
    buffer : byte[], 
    offsetInBuffer : int, 
    count : int
) : long

パラメータ

offset

SqlBytes インスタンス内の値のオフセット位置 (Int64 long 値)。

buffer

コピー対象のバイト配列バッファ。

offsetInBuffer

バッファ内のコピー開始位置を示すオフセット値 (Int32 整数)。

count

コピーするバイト数を表す Int32 型の整数。

戻り値
コピーされたバイト数を表す Int64 long 値。

解説

MaxLength を超える文字長を読み込もうとすると、例外がスローされます。

offset から終端位置までの範囲を超えるバイト数を count に指定してコピーしようとすると、範囲内のバイトだけがコピーされます。

コピー先のバッファが null 参照の場合、例外がスローされます。

コピー先のバッファが、必要な文字数を受け取ることができなかった場合、例外がスローされます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SqlBytes クラス
SqlBytes メンバ
System.Data.SqlTypes 名前空間
その他の技術情報
SqlTypes の使用