DbParameter.Size 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 die maximale Größe der Daten innerhalb der Spalte in Bytes ab oder legt sie fest.
public:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride Property Size As IntegerEigenschaftswert
Die maximale Größe der Daten in Bytes innerhalb der Spalte. Der Standardwert wird vom Parameterwert abgeleitet.
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. Bei Unicode-Zeichenfolgendaten Size bezieht sich auf die Anzahl der Zeichen. Die Anzahl für Zeichenfolgen enthält nicht das Endzeichen.
Bei 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 Size die Menge der an den Server gesendeten Daten auf die ersten hundert Zeichen beschränkt werden.
Für bidirektionale und Ausgabeparameter und Rückgabewerte müssen Sie den Wert von Size. Dies ist für Eingabeparameter nicht erforderlich, und wenn der Wert nicht explizit festgelegt wird, wird der Wert von der tatsächlichen Größe des angegebenen Parameters abgeleitet, wenn eine parametrisierte Anweisung ausgeführt wird.
Die DbType Eigenschaften Size eines Parameters können durch Festlegen Valueabgeleitet werden. Daher müssen Sie sie nicht angeben. Sie werden jedoch nicht in DbParameter den Eigenschafteneinstellungen verfügbar gemacht. Wenn beispielsweise die Größe des Parameters abgeleitet wurde, Size enthält er nach der Ausführung der Anweisung keinen abgeleiteten Wert.
Bei Datentypen mit fester Länge wird der Wert Size ignoriert. Sie kann zu Informationszwecken abgerufen werden und gibt die maximale Anzahl von Bytes zurück, die der Anbieter beim Übertragen des Werts des Parameters an den Server verwendet.
Wenn die Größe des für einen DbParameter wert angegebenen Werts Sizeüberschritten wird, enthält der ValueDbParameter Wert den angegebenen Wert, der auf die Größe der DbParameterZeichenfolge abgeschnitten ist.
Für Parameter vom Typ DbType.String, der Wert der Size Länge in Unicode-Zeichen. Für Parameter vom Typ DbType.Xml, Size wird ignoriert.
