SqlUserDefinedTypeAttribute.Format プロパティ

.NET Framework クラス ライブラリ リファレンス

SqlUserDefinedTypeAttribute.Format プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Format のいずれかのシリアル化形式。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Format As Format

Visual Basic (使用法)

Dim instance As SqlUserDefinedTypeAttribute
Dim value As Format

value = instance.Format

C#

public Format Format { get; }

C++

public:
property Format Format {
    Format get ();
}

J#

/** @property */
public Format get_Format ()

JScript

public function get Format
 () : Format

プロパティ値
シリアル化形式を表す Format 値。

解説

シリアル化形式を示す Format には、Native または UserDefined を指定できます。Native シリアル化形式には、SQL Server が UDT 表現をディスク上に効率よく格納できるようにする、きわめてシンプルなアルゴリズムが使用されています。

Native 形式には次の要件があります。

• 型には少なくとも 1 つのメンバが含まれている必要があります。値のサイズをゼロ バイトにすることはできません。

• 型に MaxByteSize 値を指定することはできません。

• UDT のフィールドは、シリアル化可能ないずれかの型 (bool、byte、sbyte、short、ushort、int、uint、long、ulong、float、double、SqlByte、SqlInt16、SqlInt32、SqlInt64、SqlDateTime、SqlSingle、SqlDouble、SqlMoney)、または、これらの型のフィールドから成る、ユーザー定義の値型であることが必要です。

• フィールドを明示的なレイアウトとして宣言することはできません。

• UDT を構造体ではなくクラス内で定義している場合、StructLayoutAttribute を StructLayout.LayoutKindSequential として指定する必要があります。この属性によってデータ フィールドの物理的なレイアウトが制御され、メンバの位置を固定してレイアウトできます。複数のフィールドを持つ UDT については、SQL Server がこの属性を使用してフィールドの並び順を特定します。

• 型に MaxByteSize 値を指定することはできません。

開発者は UserDefined 形式を使用して、バイナリ形式を詳細に制御できます。UserDefined 形式には次の要件があります。

• IsByteOrdered 属性のプロパティを指定する必要があります。既定値は false です。

• SqlUserDefinedTypeAttribute の MaxByteSize プロパティに、1 ～ 8000 の値を指定する必要があります。

• クラスに IBinarySerialize インターフェイスを実装して、Read メソッドおよび Write メソッドを実装する必要があります。Read メソッドまたは Write メソッドのいずれかのフィールドを省略した場合、フィールドの状態がシリアル化されません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlUserDefinedTypeAttribute クラス
SqlUserDefinedTypeAttribute メンバ
Microsoft.SqlServer.Server 名前空間