SqlFacetAttribute クラス

定義

名前空間:

Microsoft.Data.SqlClient.Server

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v4.1.0

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

public ref class SqlFacetAttribute : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)>]
type SqlFacetAttribute = class
    inherit Attribute

Public Class SqlFacetAttribute
Inherits Attribute

継承

Attribute

SqlFacetAttribute

属性

AttributeUsageAttribute

注釈

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

SqlFacetAttribute は戻り値の型に関する情報を派生させるためにのみ使用され、型に格納できる内容に関する制約指定を意図したものではありません。 したがって、フィールドのサイズが SqlFacetAttribute 2 文字であることを示す がある場合、フィールド アクセス式のSQL Server型はサイズ 2 になりますが、フィールドへの割り当ては、このファセットによって制限されません。

次の表は、特定のフィールド型のさまざまなプロパティの有効な値のマトリックスを示しています。 この表では、"Y" はプロパティが有効であることを示し、"N" はプロパティが無効であることを示します。

指定した SqlFacetAttribute は、フィールド型と互換性がある必要があります。 プロパティが無効な場合、ユーザーがプロパティの既定値以外の値を指定した場合、型の登録でエラーが報告されます。 プロパティと Scale プロパティのPrecision最大値は 38 です。 プロパティの MaxSize 値は、バイナリ データと非 Unicode データの場合は 1 から 8000、Unicode データの場合は 1 から 4000、-1 の範囲である必要があります。 その他の値はすべて無効です。

種類	IsFixedLength	MaxSize	有効桁数	スケール	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
DateTime	N	N	N	Y1	N
Decimal	N	N	Y	Y	Y

(1) DateTime 型にスケールを指定すると、指定したスケールを持つ DateTime2 型として Transact-SQL に値が返されます。

コンストラクター

SqlFacetAttribute()

返されるユーザー定義型 (UDT) に対するオプションの属性。返される結果に対し、Transact-SQL で使用可能な補足情報を含む注釈を付けます。

プロパティ

IsFixedLength	返されるユーザー定義型が固定長であるかどうかを示します。
IsNullable	ユーザー定義型の戻り値の型に null が許容されているかどうかを示します。
MaxSize	ユーザー定義型の基になるフィールド型の最大サイズ (論理単位)。
Precision	返されるユーザー定義型の有効桁数。
Scale	返されるユーザー定義型の小数点以下桁数。