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

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

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

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

Type	IsFixedLength	MaxSize	Точность	Масштабирование	IsNullable
SqlBoolean	Нет	Нет	N	N	Да
SqlByte	N	N	N	N	Да
SqlInt16	N	N	N	N	Да
SqlInt32	N	N	N	N	Да
SqlInt64	N	N	N	N	Да
SqlSingle	N	N	N	Нет	Да
SqlDouble	N	Нет	N	N	Да
SqlDateTime	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	Да	Да	N	N	Да
SqlChars	Да	Да	N	Нет	Да
Внедренные определяемые пользователем функции	Нет	N	Нет	N	Да
String	Да	Да	N	N	Да
Byte[]	Да	Да	N	N	Да
Char[]	Да	Да	N	N	Да
DateTime	N	N	Нет	Да1	Нет
Decimal	N	N	Да	Да	Да

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

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

SqlFacetAttribute()

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

Свойства

IsFixedLength	Показывает, имеет ли тип возвращаемого значения пользовательского типа фиксированную длину.
IsNullable	Показывает, допускается ли null в качестве типа возвращаемого значения пользовательского типа.
MaxSize	Максимальный размер базового типа поля для пользовательского типа (в логических единицах).
Precision	Точность типа возвращаемого значения пользовательского типа.
Scale	Масштаб типа возвращаемого значения пользовательского типа.