SqlUserDefinedTypeAttribute.MaxByteSize プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
インスタンスのバイト単位の最大サイズ。
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 Integerプロパティ値
インスタンスの最大サイズを表す Int32 値。
注釈
シリアル化 Formatを使用して MaxByteSize プロパティを指定するUserDefined必要があります。
SQL Server 2005 以前に接続する場合は、 MaxByteSize 1 から 8000 の間にする必要があります。
SQL Server 2008 以降に接続する場合は、インスタンスが常に 8,000 バイト以下の型に対して 1 ~ 8000 を設定MaxByteSizeします。 インスタンスが 8000 より大きい型の場合は、-1 を指定します。
UDT にユーザー定義のシリアル化を指定した場合、MaxByteSize は、ユーザーが定義した形式でシリアル化された UDT の合計サイズを表します。 たとえば、10 文字 (Char) の文字列プロパティを持つ UDT について考えてみましょう。 UDT が を使用して BinaryWriterシリアル化される場合、シリアル化された文字列の合計サイズは 22 バイトです。Unicode UTF-16 文字あたり 2 バイト、最大文字数を乗算し、バイナリ ストリームのシリアル化に伴うオーバーヘッドの制御バイト数を 2 に乗算します。 そのため、 の MaxByteSize値を決定するときは、シリアル化された UDT の合計サイズ (バイナリ形式でシリアル化されたデータのサイズとシリアル化によって発生するオーバーヘッド) を考慮する必要があります。
このプロパティは、シリアル化 FormatではNative使用しないでください。