SqlUserDefinedTypeAttribute.MaxByteSize Propriété

Définition

Espace de noms:

Microsoft.SqlServer.Server

Assembly:

Microsoft.SqlServer.Server.dll

Paquet:

Microsoft.SqlServer.Server v1.0.0

Taille maximale de l'instance, en octets.

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

Valeur de propriété

Int32

Valeur Int32 représentant la taille maximale de l'instance.

Remarques

Vous devez spécifier la MaxByteSize propriété avec la UserDefined sérialisation Format.

Lors de la connexion à SQL Server 2005 ou version antérieure, MaxByteSize doit être compris entre 1 et 8000.

Lors de la connexion à SQL Server 2008 ou version ultérieure, définissez MaxByteSize entre 1 et 8 000, pour un type dont les instances sont toujours inférieures ou égales à 8 000 octets. Pour les types qui peuvent avoir des instances supérieures à 8 000, spécifiez -1.

Pour un type défini par l'utilisateur assorti d'une sérialisation définie par l'utilisateur, MaxByteSize fait référence à la taille totale du type défini par l'utilisateur dans sa forme sérialisée, telle que définie par l'utilisateur. Imaginez un type défini par l'utilisateur assorti d'une propriété d'une chaîne de 10 caractères (Char). Lorsque l’UDT est sérialisé à l’aide d’un BinaryWriter, la taille totale de la chaîne sérialisée est de 22 octets : 2 octets par caractère Unicode UTF-16, multiplié par le nombre maximal de caractères, plus 2 octets de contrôle de la surcharge occasionnée par la sérialisation d’un flux binaire. Ainsi, lors de la détermination de la valeur de MaxByteSize, la taille totale du type défini par l’utilisateur sérialisé doit être prise en compte : la taille des données sérialisées sous forme binaire plus la surcharge occasionnée par la sérialisation.

Cette propriété ne doit pas être utilisée avec Native la sérialisation Format.