SqlParameter.Offset プロパティ

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

Public Property Offset As Integer
[C#]
public int Offset {get; set;}
[C++]
public: __property int get_Offset();public: __property void set_Offset(int);
[JScript]
public function get Offset() : int;public function set Offset(int);

プロパティ値

Value へのオフセット。既定値は 0 です。

解説

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

このプロパティは、バイナリ型および文字列型に使用します。バイナリ型の場合はバイト数、文字列型の場合は文字数が返されます。文字列の文字数に、終端文字は含まれません。

使用例

[Visual Basic, C#, C++] SqlParameter を作成し、そのプロパティの一部を設定する例を次に示します。

 
Public Sub CreateSqlParameter()
    Dim myParameter As New SqlParameter("@Description", SqlDbType.VarChar)
    myParameter.IsNullable = True
    myParameter.Offset = 3
End Sub 'CreateSqlParameter

[C#] 
public void CreateSqlParameter() 
 {
    SqlParameter myParameter = new SqlParameter("@Description", SqlDbType.VarChar);
    myParameter.IsNullable = true;
    myParameter.Offset = 3;
 }

[C++] 
public:
void CreateSqlParameter() 
 {
    SqlParameter* myParameter = new SqlParameter(S"@Description", SqlDbType::VarChar);
    myParameter->IsNullable = true;
    myParameter->Offset = 3;
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlParameter クラス | SqlParameter メンバ | System.Data.SqlClient 名前空間