SqlChars.Read メソッド

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

SqlChars.Read メソッド

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As SqlChars
Dim offset As Long
Dim buffer As Char()
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,
    char[] buffer,
    int offsetInBuffer,
    int count
)

C++

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

J#

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

JScript

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

パラメータ

offset

SqlChars インスタンス内の値のオフセット位置 (Int64long 値)。

buffer

コピー対象の文字配列バッファ。

offsetInBuffer

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

count

コピーする文字数を表す Int32 型の整数値。

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

解説

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

offsetInBuffer から終端位置までの範囲を超える文字数を 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

参照

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