Freigeben über


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

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är- und Zeichenfolgentypen verwendet.

Bei Nichtzeichenfolgendatentypen und ANSI-Zeichenfolgendaten bezieht sich die Size -Eigenschaft auf die Anzahl von Bytes. Bei Unicode-Zeichenfolgendaten Size bezieht sich auf die Anzahl von Zeichen. Die Anzahl für Zeichenfolgen enthält nicht das beendende Zeichen.

Beschreibt für Datentypen mit variabler Länge die maximale Datenmenge, Size die an den Server übertragen werden soll. Beispielsweise kann 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 Parameter und Ausgabeparameter sowie Rückgabewerte müssen Sie den Wert von Sizefestlegen. Dies ist für Eingabeparameter nicht erforderlich, und wenn er nicht explizit festgelegt ist, wird der Wert von der tatsächlichen Größe des angegebenen Parameters abgeleitet, wenn eine parametrisierte Anweisung ausgeführt wird.

Die DbType Eigenschaften und Size eines Parameters können durch Festlegen Valuevon abgeleitet werden. Daher müssen Sie sie nicht angeben. Sie werden jedoch nicht in DbParameter Eigenschafteneinstellungen verfügbar gemacht. Wenn beispielsweise die Größe des Parameters abgeleitet wurde, Size enthält nach der Ausführung der Anweisung keinen abgeleiteten Wert.

Bei Datentypen mit fester Länge wird der Wert von Size ignoriert. Sie kann zu Informationszwecken abgerufen werden und gibt die maximale Bytemenge zurück, die der Anbieter bei der Übertragung des Werts des Parameters an den Server verwendet.

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

Für Parameter des Typs DbType.String ist der Wert von Size länge in Unicode-Zeichen. Für Parameter vom Typ DbTypewirdXmlSize ignoriert.

Gilt für:

Weitere Informationen