다음을 통해 공유

SqlFacetAttribute 클래스

  • 참조

정의

네임스페이스:
Microsoft.SqlServer.Server
어셈블리:
System.Data.SqlClient.dll
어셈블리:
System.Data.dll
어셈블리:
Microsoft.SqlServer.Server.dll
패키지:
System.Data.SqlClient v4.8.5
패키지:
Microsoft.SqlServer.Server v1.0.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 경우 값은 이진 및 비유니코드 데이터의 경우 1-8000, 유니코드 데이터의 경우 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

사용자 정의 형식의 반환 형식에 대한 소수 자릿수입니다.

적용 대상