Freigeben über


SqlUserDefinedAggregateAttribute.MaxByteSize Eigenschaft

Definition

Die maximale Größe der Aggregatinstanz in Bytes.

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

Ein Int32-Wert, der die maximale Größe der Aggregatinstanz darstellt.

Hinweise

Diese Eigenschaft muss nicht für die Serialisierung im nativen Format angegeben werden.

Sie müssen die MaxByteSize -Eigenschaft mit der Serialisierung FormatUserDefined angeben.

Der maximal zulässige Wert für diese Eigenschaft wird durch das MaxByteSizeValue -Feld angegeben.

Die maximal zulässige Größe beträgt 2 GB. Sie können eine Zahl von 1 bis 8.000 Bytes oder -1 angeben, um einen Wert von mehr als 8.000 Bytes oder bis zu 2 GB darzustellen.

Bei einem Aggregat mit angegebener MaxByteSize benutzerdefinierter Serialisierung bezieht sich auf die Gesamtgröße der serialisierten Daten. Erwägen Sie ein Aggregat, das eine Zeichenfolge mit 10 Zeichen (Char) serialisiert. Wenn die Zeichenfolge mit serialisiert BinaryWriterwird, beträgt die Gesamtgröße der serialisierten Zeichenfolge 22 Byte: 2 Bytes pro Unicode UTF-16-Zeichen, multipliziert mit der maximalen Anzahl von Zeichen, plus 2 Steuerbytes des Mehraufwands, der beim Serialisieren eines binären Datenstroms entsteht. Bei der Bestimmung des Werts von MaxByteSizemuss also die Gesamtgröße der serialisierten Daten berücksichtigt werden: die Größe der daten, die in binärer Form serialisiert wurden, plus der Durchserialisierung entstandene Mehraufwand.

Gilt für: