Freigeben über


SqlParameter.Offset Eigenschaft

Definition

Ruft den Offset zur Value-Eigenschaft ab oder legt diesen fest.

public:
 property int Offset { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int Offset { get; set; }
public int Offset { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.Offset : int with get, set
member this.Offset : int with get, set
Public Property Offset As Integer

Eigenschaftswert

Der Offset zu Value. Die Standardeinstellung ist 0.

Attribute

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Die Offset -Eigenschaft wird zum clientseitigen Blockieren von Binär- und Zeichenfolgendaten verwendet. Um beispielsweise 10 MB Text in eine Spalte auf einem Server einzufügen, kann ein Benutzer 10 parametrisierte Einfügungen von 1 MB Blöcken ausführen, wobei der Wert von Offset bei jeder Iteration um 1 MB verschoben wird.

Offset gibt die Anzahl der Bytes für Binärtypen und die Anzahl der Zeichen für Zeichenfolgen an. Die Anzahl für Zeichenfolgen enthält nicht das beendende Zeichen.

Gilt für: