Teilen ü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); };
public int Offset { get; set; }
[System.ComponentModel.Browsable(false)]
[System.Data.DataSysDescription("SqlParameter_Offset")]
public int Offset { get; set; }
[System.ComponentModel.Browsable(false)]
public int Offset { get; set; }
member this.Offset : int with get, set
[<System.ComponentModel.Browsable(false)>]
[<System.Data.DataSysDescription("SqlParameter_Offset")>]
member this.Offset : int with get, set
[<System.ComponentModel.Browsable(false)>]
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.

static void CreateSqlParameterOffset()
{
    SqlParameter parameter = new SqlParameter("pDName", SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.Offset = 3;
}
Private Sub CreateSqlParameterOffset()
    Dim parameter As New SqlParameter("pDName", SqlDbType.VarChar)
    parameter.IsNullable = True
    parameter.Offset = 3
End Sub

Hinweise

Die Offset -Eigenschaft wird für clientseitige Blöcke 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ügevorgänge mit 1 MB Blöcken ausführen, wobei der Wert von Offset bei jeder Iteration um 1 MB verschoben wird.

Offset gibt die Anzahl von 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:

Weitere Informationen