SqlUserDefinedTypeAttribute.MaxByteSize 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.
Die maximale Größe der Instanz in Byte.
public:
property int MaxByteSize { int get(); void set(int value); };public int MaxByteSize { get; set; }member this.MaxByteSize : int with get, setPublic Property MaxByteSize As IntegerEigenschaftswert
Ein Int32-Wert, der die maximale Größe der Instanz darstellt.
Hinweise
Sie müssen die MaxByteSize -Eigenschaft mit der UserDefined Serialisierung Formatangeben.
Wenn Sie eine Verbindung mit SQL Server 2005 oder früher herstellen, MaxByteSize muss zwischen 1 und 8000 sein.
Wenn Sie eine Verbindung mit SQL Server 2008 oder höher herstellen, legen Sie MaxByteSize für einen Typ, dessen Instanzen immer 8.000 Bytes oder weniger sind, zwischen 1 und 8000 fest. Geben Sie für Typen, die über Instanzen größer als 8000 verfügen können, -1 an.
Bei einem UDT, für den benutzerdefinierte Serialisierung festgelegt ist, bezieht sich MaxByteSize auf die Gesamtgröße des UDTs in der vom Benutzer festgelegten serialisierten Form. Angenommen, für einen UDT ist eine Zeichenfolge von 10 Zeichen (Char) festgelegt. Wenn der UDT mit serialisiert BinaryWriterwird, beträgt die Gesamtgröße der serialisierten Zeichenfolge 22 Bytes: 2 Bytes pro Unicode UTF-16-Zeichen, multipliziert mit der maximalen Anzahl von Zeichen, plus 2 Steuerbytes an Mehraufwand, der durch die Serialisierung eines binären Datenstroms entsteht. Bei der Bestimmung des Werts von MaxByteSizemuss also die Gesamtgröße des serialisierten UDT berücksichtigt werden: die Größe der in binärer Form serialisierten Daten plus der durch die Serialisierung verursachten Mehraufwand.
Diese Eigenschaft sollte nicht mit Native der Serialisierung Formatverwendet werden.