SqlFacetAttribute Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 AttributePublic 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 que indica seu tamanho como 2 caracteres, o tipo SQL Server da expressão de acesso de 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 | Y |
| SqlByte | N | N | N | N | Y |
| SqlInt16 | N | N | N | N | Y |
| SqlInt32 | N | N | N | N | Y |
| SqlInt64 | N | N | N | N | Y |
| SqlSingle | N | N | N | N | Y |
| SqlDouble | N | N | N | N | Y |
| SqlDateTime | N | N | N | N | Y |
| SqlMoney | N | N | N | N | Y |
| SqlGuid | N | N | N | N | Y |
| SqlDecimal | N | N | Y | Y | Y |
| SqlString | Y | Y | N | N | Y |
| SqlBinary | Y | Y | N | N | Y |
| SqlXml | N | N | N | N | Y |
| SqlBytes | Y | Y | N | N | Y |
| SqlChars | Y | Y | N | N | S |
| UDTs inseridos | N | N | N | N | Y |
| String | Y | Y | N | N | S |
| Byte[] | S | Y | N | N | S |
| Char[] | S | Y | N | N | Y |
| DateTime | N | N | N | S1 | N |
| Decimal | N | N | Y | Y | S |
(1) Especificar a escala em um tipo DateTime fará com que o valor seja retornado ao 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 |
| 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. |