SqlUserDefinedTypeAttribute.MaxByteSize 屬性

定義

命名空間:

Microsoft.SqlServer.Server

組件:

Microsoft.SqlServer.Server.dll

套件:

Microsoft.SqlServer.Server v1.0.0

執行個體的大小最大值 (位元組)。

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

屬性值

Int32

Int32 值，表示執行個體的最大大小。

備註

您必須使用UserDefined串行化 Format來指定 MaxByteSize 屬性。

連線到 SQL Server 2005 或更早版本時，MaxByteSize必須介於 1 到 8000 之間。

連接到 SQL Server 2008 或更新版本時，針對實例一律為 8,000 個字節或更少的類型設定MaxByteSize為 1 到 8000。 對於可以具有大於 8000 之實例的類型，請指定 -1。

如果 UDT 已指定使用者定義的序列化，對此 UDT 而言，MaxByteSize 是指 UDT 在其序列化形式 (由使用者所定義) 的總大小。 以一個具有 10 個字元字串之屬性的 UDT (Char) 為例。 使用 BinaryWriter串行化 UDT 時，串行化字串的總大小為 22 個字節：每個 Unicode UTF-16 字元 2 個字節，乘以字元數目上限，再加上串行化二進位數據流所產生的額外負荷 2 個控制位元組。 因此，判斷的值 MaxByteSize時，必須考慮串行化 UDT 的總大小：以二進位格式串行化的數據大小加上串行化所產生的額外負荷。

這個屬性不應該與串行化 Format搭配Native使用。