Compartilhar via


SqlFacetAttribute Classe

Definição

Anota o resultado retornado de um UDT (tipo definido pelo usuário) com informações adicionais que podem ser usadas no 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
Herança
SqlFacetAttribute
Atributos

Comentários

SqlFacetAttribute só pode ser especificado em valores retornados não nulos.

SqlFacetAttribute é usado apenas para derivar informações sobre o tipo de retorno e não se destina a ser uma especificação de restrição no que pode ser armazenado no tipo. Portanto, se um campo tiver um SqlFacetAttribute indicando seu tamanho como 2 caracteres, o tipo SQL Server da expressão de acesso ao campo será de tamanho 2, mas as atribuições no campo não serão restritas por essa faceta.

A tabela a seguir captura a matriz de valores válidos para as várias propriedades para tipos de campo específicos. Nesta tabela, "Y" indica que a propriedade é válida e "N" indica que a propriedade não é válida.

O especificado SqlFacetAttribute deve ser compatível com o tipo de campo. Se a propriedade não for válida, o registro de tipo relatará um erro se o usuário especificar um valor não padrão para a propriedade. Os valores máximos para Precision as propriedades e Scale são 38. Para a MaxSize propriedade , o valor deve estar no intervalo de 1-8000 para dados binários e não Unicode, 1-4000 para dados Unicode ou -1. Todos os outros valores não são válidos.

Tipo IsFixedLength MaxSize Precisão Escala IsNullable
SqlBoolean N N N N S
SqlByte N N N N S
SqlInt16 N N N N S
SqlInt32 N N N N S
SqlInt64 N N N N S
SqlSingle N N N N S
SqlDouble N N N N S
SqlDateTime N N N N S
SqlMoney N N N N S
SqlGuid N N N N S
SqlDecimal N N S S S
SqlString S S N N S
SqlBinary S S N N S
SqlXml N N N N S
SqlBytes S S N N S
SqlChars S S N N S
UDTs inseridos N N N N S
String S S N N S
Byte[] S S N N S
Char[] S S N N S
DateTime N N N S1 N
Decimal N N S S S

(1) Especificar a escala em um tipo DateTime fará com que o valor seja retornado para Transact-SQL como um tipo DateTime2 com a escala especificada.

Construtores

SqlFacetAttribute()

Um atributo opcional em um tipo de retorno UDT (tipo definido pelo usuário), usado para anotar o resultado retornado com informações adicionais que podem ser usadas no Transact-SQL.

Propriedades

IsFixedLength

Indica se o tipo de retorno do tipo definido pelo usuário é de comprimento fixo.

IsNullable

Indica se o tipo de retorno do tipo definido pelo usuário pode ser null.

MaxSize

O tamanho máximo, em unidades lógicas, do tipo de campo subjacente do tipo definido pelo usuário.

Precision

A precisão do tipo de retorno do tipo definido pelo usuário.

Scale

A escala do tipo de retorno do tipo definido pelo usuário.

Aplica-se a