DbParameter.Size Eigenschaft

Definition

Ruft die maximale Größe der Daten in der Spalte in Byte ab oder legt diese fest.

public:
 abstract property int Size { int get(); void set(int value); };
public abstract int Size { get; set; }
member this.Size : int with get, set
Public MustOverride Property Size As Integer

Eigenschaftswert

Int32

Die maximale Größe in Byte der Daten in der Spalte. Der Standardwert wird aus dem Parameterwert hergeleitet.

Implementiert

Hinweise

Die Size Eigenschaft wird für binäre und Zeichenfolgentypen verwendet.

Bei Nichtzeichenfolgendaten und ANSI-Zeichenfolgendaten bezieht sich die Size Eigenschaft auf die Anzahl der Bytes. Für Unicode-Zeichenfolgendaten Size bezieht sich die Anzahl der Zeichen. Die Anzahl für Zeichenfolgen enthält nicht das Endzeichen.

Für Datentypen mit variabler Länge wird die maximale Datenmenge beschrieben, Size die an den Server übertragen werden soll. Beispielsweise könnte für einen Unicode-Zeichenfolgenwert verwendet werden, Size um die Menge der an den Server gesendeten Daten auf die ersten hundert Zeichen zu beschränken.

Für bidirektionale und Ausgabeparameter und Rückgabewerte müssen Sie den Wert von Size. Dies ist nicht für Eingabeparameter erforderlich, und wenn dieser nicht explizit festgelegt wird, wird der Wert von der tatsächlichen Größe des angegebenen Parameters abgeleitet, wenn eine parametrisierte Anweisung ausgeführt wird.

Size Die DbType Eigenschaften eines Parameters können durch Festlegen Valueabgeleitet werden. Daher sind Sie nicht erforderlich, um sie anzugeben. Sie werden jedoch nicht in DbParameter Eigenschafteneinstellungen verfügbar gemacht. Wenn beispielsweise die Größe des Parameters verzögert wurde, Size enthält er nach der Ausführung der Anweisung keinen verzögerten Wert.

Bei Datentypen fester Länge wird der Wert Size ignoriert. Sie kann für Informationszwecke abgerufen werden und gibt die maximale Menge von Bytes zurück, die der Anbieter verwendet, wenn der Wert des Parameters an den Server übertragen wird.

Wenn die Größe des für einen DbParameter bereitgestellten Werts den angegebenen SizeWert überschreitet, enthält dies Value DbParameter den angegebenen Wert, der auf die Größe des Werts DbParameterabgeschnitten wird.

Bei Parametern vom Typ DbType.String, ist der Wert der Size Länge in Unicode-Zeichen. Bei Parametern vom Typ DbType.Xml, Size wird ignoriert.

Gilt für

Siehe auch