SqlParameter.Offset Eigenschaft
Definition
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); };[System.ComponentModel.Browsable(false)]
public int Offset { get; set; }public int Offset { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.Offset : int with get, setmember this.Offset : int with get, setPublic Property Offset As IntegerEigenschaftswert
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.