SqlFacetAttribute Classe

Definição

Namespace:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v4.1.0

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

Attribute

SqlFacetAttribute

Atributos

AttributeUsageAttribute

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.