SqlParameter.Offset Eigenschaft

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Freigeben über