SqlFacetAttribute クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SqlFacetAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

結果として返されるユーザー定義型 (UDT) に、Transact-SQL で使用可能な補足情報を含む注釈を付けます。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Property Or AttributeTargets.Field
 Or AttributeTargets.Parameter Or AttributeTargets.ReturnValue,
 AllowMultiple:=False, Inherited:=False)> _
Public Class SqlFacetAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SqlFacetAttribute

[AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=false, Inherited=false)] 
public class SqlFacetAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Property|AttributeTargets::Field|AttributeTargets::Parameter|AttributeTargets::ReturnValue,
 AllowMultiple=false, Inherited=false)] 
public ref class SqlFacetAttribute : public
 Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=false, Inherited=false) */
 
public class SqlFacetAttribute extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 AllowMultiple=false, Inherited=false) 
public class SqlFacetAttribute extends
 Attribute

解説

SqlFacetAttribute は、void 以外の戻り値に対してのみ指定できます。

SqlFacetAttribute は、戻り値の型に関する情報を取り出す目的でのみ使用し、型に格納できる情報を制約することを意図したものではありません。したがって、"サイズが 2 文字である" ということを示す SqlFacetAttribute がフィールドに割り当てられていた場合、フィールドアクセス式によって返される SQL Server のデータ型が 2 というサイズを持つことを示すだけで、フィールドに代入できる値がこのファセットによって制約されるわけではありません。

以下の表は、特定のフィールド型の各種プロパティで有効な値をまとめたものです。表中の "Y" は、そのプロパティが有効なことを、また、"N" は、そのプロパティが無効であることを示します。

フィールド型に対して有効な SqlFacetAttribute 値を指定する必要があります。プロパティが無効である場合、そのプロパティに対して既定値以外の値を指定すると、型の登録時にエラーが報告されます。Precision プロパティおよび Scale プロパティの最大値は 38 です。MaxSize プロパティに指定できる値の範囲は、1 ～ 8000 (バイナリデータと非 Unicode データの場合)、1 ～ 4000 (Unicode データの場合)、または -1 になります。それ以外の値はすべて無効です。

型	IsFixedLength	MaxSize	Precision	Scale	IsNullable
SqlBoolean	N	N	N	N	Y
SqlByte	N	N	N	N	Y
SqlInt16	N	N	N	N	Y
SqlInt32	N	N	N	N	Y
SqlInt64	N	N	N	N	Y
SqlSingle	N	N	N	N	Y
SqlDouble	N	N	N	N	Y
SqlDateTime	N	N	N	N	Y
SqlMoney	N	N	N	N	Y
SqlGuid	N	N	N	N	Y
SqlDecimal	N	N	Y	Y	Y
SqlString	Y	Y	N	N	Y
SqlBinary	Y	Y	N	N	Y
SqlXml	N	N	N	N	Y
SqlBytes	Y	Y	N	N	Y
SqlChars	Y	Y	N	N	Y
埋め込み UDT	N	N	N	N	Y
String	Y	Y	N	N	Y
Byte[]	Y	Y	N	N	Y
Char[]	Y	Y	N	N	Y
Decimal	N	N	Y	Y	Y