SqlParameter.Offset Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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

Int32

Der Offset zu Value. Die Standardeinstellung ist 0.

Attribute
BrowsableAttribute DataSysDescriptionAttribute

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ü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 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