SqlUserDefinedTypeAttribute.MaxByteSize Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v4.1.0

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, set

Public Property MaxByteSize As Integer

Eigenschaftswert

Int32

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 müssen Sie zwischen 1 und 8000 sein.

Legen Sie beim Herstellen einer Verbindung mit SQL Server 2008 oder höher für einen Typ, dessen Instanzen immer 8.000 Bytes oder weniger sind, zwischen 1 und 8000 festMaxByteSize. Geben Sie für Typen, die Instanzen größer als 8000 aufweisen 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 die UDT mit einem BinaryWriterserialisiert wird, 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 Kontrollbytes an Mehraufwand, der beim Serialisieren 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.