SqlParameter.Offset プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SqlParameter.Offset プロパティ

Value プロパティへのオフセットを取得または設定します。

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

Visual Basic (宣言)

Public Property Offset As
 Integer

Visual Basic (使用法)

Dim instance As SqlParameter
Dim value As Integer

value = instance.Offset

instance.Offset = value

public int Offset { get;
 set; }

C++

public:
property int Offset {
    int get ();
    void set (int value);
}

/** @property */
public int get_Offset ()

/** @property */
public void set_Offset (int
 value)

JScript

public function get Offset
 () : int

public function set Offset
 (value : int)

プロパティ値
Value へのオフセット。既定値は 0 です。

解説

Offset プロパティは、クライアント側でのバイナリデータと文字列データのチャンク処理に使用します。たとえば、10 MB のテキストをサーバーの列に挿入する場合、ユーザーは、1 回ごとに 1 MB ずつ Offset の値をシフトして、1 MB のチャンクのパラメータ化された挿入を 10 回実行できます。

Offset は、バイナリ型のバイト数、および文字列の文字数を指定します。文字列の文字数に、終端文字は含まれません。

使用例

SqlParameter を作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

Private Sub CreateSqlParameterOffset()
    Dim parameter As New
 SqlParameter("pDName", SqlDbType.VarChar)
    parameter.IsNullable = True
    parameter.Offset = 3
End Sub

static void CreateSqlParameterOffset()
{
    SqlParameter parameter = new SqlParameter("pDName",
 SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.Offset = 3;
}

プラットフォーム

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