SqlFacetAttribute SqlFacetAttribute SqlFacetAttribute SqlFacetAttribute Class

Определение

Добавляет к возвращаемому результату пользовательского типа (UDT) дополнительную информацию, которая может быть использована в Transact-SQL.Annotates the returned result of a user-defined type (UDT) with additional information that can be used in Transact-SQL.

public ref class SqlFacetAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Property | System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)]
public class SqlFacetAttribute : Attribute
type SqlFacetAttribute = class
    inherit Attribute
Public Class SqlFacetAttribute
Inherits Attribute
Наследование
SqlFacetAttributeSqlFacetAttributeSqlFacetAttributeSqlFacetAttribute
Атрибуты

Комментарии

SqlFacetAttributeможет указываться только для возвращаемых значений, отличных от void.SqlFacetAttribute may only be specified on non-void return values.

SqlFacetAttributeиспользуется только для получения сведений о возвращаемом типе и не предназначен для определения ограничения на то, что может храниться в типе.SqlFacetAttribute is used only to derive information about the return type, and is not intended to be a constraint specification on what can be stored in the type. Таким словами, если поле имеет значение SqlFacetAttribute , которое указывает, что его размер равен 2 символам, то тип SQL Server выражения доступа к полю имеет размер 2, но присваивания в поле не ограничиваются этим аспектом.Thus, if a field has a SqlFacetAttribute indicating its size to be 2 characters, then the SQL Server type of the field access expression is of size 2, but assignments into the field are not restricted by this facet.

В следующей таблице показана матрица допустимых значений для различных свойств конкретных типов полей.The table below captures the matrix of valid values for the various properties for specific field types. В этой таблице "Y" указывает, что свойство является допустимым, а "N" означает, что свойство является недопустимым.In this table, "Y" indicates that the property is valid, and "N" indicates that the property is not valid.

Указанный SqlFacetAttribute тип должен быть совместим с типом поля.The specified SqlFacetAttribute must be compatible with the field type. Если свойство является недопустимым, при регистрации типа будет выводится сообщение об ошибке, если пользователь указывает значение свойства, отличное от значения по умолчанию.If the property is not valid, type registration will report an error if the user specifies a non-default value for the property. Максимальное значение Precision свойств и Scale равно 38.The maximum values for Precision and Scale properties are 38. MaxSize Для свойства значение должно находиться в диапазоне 1-8000 для данных в двоичном и не в Юникоде, 1-4000 для данных в Юникоде или-1.For the MaxSize property, the value should be in the range of 1-8000 for binary and non-Unicode data, 1-4000 for Unicode data, or -1. Все остальные значения недопустимы.All other values are not valid.

ТипType IsFixedLengthIsFixedLength MaxSizeMaxSize ТочностьPrecision МасштабScale IsNullableIsNullable
SqlBoolean вN вN вN вN YY
SqlByte вN вN вN вN YY
SqlInt16 вN вN вN вN YY
SqlInt32 вN вN вN вN YY
SqlInt64 вN вN вN вN YY
SqlSingle вN вN вN вN YY
SqlDouble вN вN вN вN YY
SqlDateTime вN вN вN вN YY
SqlMoney вN вN вN вN YY
SqlGuid вN вN вN вN YY
SqlDecimal вN вN YY YY YY
SqlString YY YY вN вN YY
SqlBinary YY YY вN вN YY
SqlXml вN вN вN вN YY
SqlBytes YY YY вN вN YY
SqlChars YY YY вN вN YY
Внедренные определяемые пользователем типыEmbedded UDTs вN вN вN вN YY
String YY YY вN вN YY
Byte[]Byte[] YY YY вN вN YY
Char[]Char[] YY YY вN вN YY
DateTime вN вN вN Y1Y1 вN
Decimal вN вN YY YY YY

(1) при указании масштаба для типа DateTime значение будет возвращено в Transact-SQL в качестве типа DateTime2 с указанной шкалой.(1) Specifying the scale on a DateTime type will cause the value to be returned to Transact-SQL as a DateTime2 type with the specified scale.

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

SqlFacetAttribute() SqlFacetAttribute() SqlFacetAttribute() SqlFacetAttribute()

Необязательный атрибут типа возвращаемого значения для пользовательского типа, используемый для добавления к возвращаемому результату заметки с дополнительными сведениями, которые могут быть использованы в Transact-SQL.An optional attribute on a user-defined type (UDT) return type, used to annotate the returned result with additional information that can be used in Transact-SQL.

Свойства

IsFixedLength IsFixedLength IsFixedLength IsFixedLength

Показывает, имеет ли тип возвращаемого значения пользовательского типа фиксированную длину.Indicates whether the return type of the user-defined type is of a fixed length.

IsNullable IsNullable IsNullable IsNullable

Показывает, допускается ли null в качестве типа возвращаемого значения пользовательского типа.Indicates whether the return type of the user-defined type can be null.

MaxSize MaxSize MaxSize MaxSize

Максимальный размер базового типа поля для пользовательского типа (в логических единицах).The maximum size, in logical units, of the underlying field type of the user-defined type.

Precision Precision Precision Precision

Точность типа возвращаемого значения пользовательского типа.The precision of the return type of the user-defined type.

Scale Scale Scale Scale

Масштаб типа возвращаемого значения пользовательского типа.The scale of the return type of the user-defined type.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

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