Поделиться через

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 Можно указать только для возвращаемых значений, не являющихся пустыми.

SqlFacetAttribute используется только для получения сведений о типе возвращаемого значения и не предназначен для ограничения того, что может храниться в типе. Таким образом, если поле имеет SqlFacetAttribute значение , указывающее, что его размер составляет 2 символа, то SQL Server тип выражения доступа к полю имеет размер 2, но назначение поля не ограничивается этим аспектом.

В таблице ниже приведена матрица допустимых значений для различных свойств для определенных типов полей. В этой таблице "Y" указывает, что свойство является допустимым, а "N" указывает, что свойство недопустимо.

Указанный SqlFacetAttribute объект должен быть совместим с типом поля. Если свойство недопустимо, регистрация типа сообщит об ошибке, если пользователь задает для свойства значение, отличное от значения по умолчанию. Максимальные значения свойств Precision и Scale — 38. MaxSize Для свойства значение должно находиться в диапазоне от 1 до 8000 для двоичных данных и данных, отличных от Юникода, от 1 до 4000 для данных Юникода или -1. Все остальные значения недопустимы.

Type IsFixedLength MaxSize Точность Масштабирование IsNullable
SqlBoolean Нет N Нет Нет Да
SqlByte N N N N Да
SqlInt16 Нет Нет Нет Нет Да
SqlInt32 Нет N N N Да
SqlInt64 Нет N Нет Нет Да
SqlSingle Нет N N N Да
SqlDouble N N N N Да
SqlDateTime N N N N Да
SqlMoney N N N N Да
SqlGuid N N N N Да
SqlDecimal N N Да Да Да
SqlString Да Да N N Да
SqlBinary Да Да N N Да
SqlXml N N N N Да
SqlBytes Да Да Нет Нет Да
SqlChars Да Да N N Да
Внедренные определяемые пользователем пользовательский тип Нет Нет N N Да
String Да Да Нет Нет Да
Byte[] Да Да N Нет Да
Char[] Да Да Нет N Да
DateTime N Нет Нет Да1 Нет
Decimal N N Да Да Да

(1) Указание шкалы для типа DateTime приведет к возврату значения в Transact-SQL в качестве типа DateTime2 с указанным масштабом.

Конструкторы

SqlFacetAttribute()

Необязательный атрибут типа возвращаемого значения для пользовательского типа, используемый для добавления к возвращаемому результату заметки с дополнительными сведениями, которые могут быть использованы в Transact-SQL.

Свойства

IsFixedLength

Показывает, имеет ли тип возвращаемого значения пользовательского типа фиксированную длину.
IsNullable

Показывает, допускается ли null в качестве типа возвращаемого значения пользовательского типа.
MaxSize

Максимальный размер базового типа поля для пользовательского типа (в логических единицах).
Precision

Точность типа возвращаемого значения пользовательского типа.
Scale

Масштаб типа возвращаемого значения пользовательского типа.

Применяется к