SqlFacetAttribute Clase

Definición

Espacio de nombres:

Microsoft.Data.SqlClient.Server

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v4.1.0

Anota el resultado devuelto de un tipo definido por el usuario (UDT) con información adicional que se puede utilizar en 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

Herencia

Attribute

SqlFacetAttribute

Atributos

AttributeUsageAttribute

Comentarios

SqlFacetAttribute solo se puede especificar en valores devueltos no nulos.

SqlFacetAttribute solo se usa para derivar información sobre el tipo de valor devuelto y no está pensada para ser una especificación de restricción sobre lo que se puede almacenar en el tipo. Por lo tanto, si un campo tiene un SqlFacetAttribute valor que indica que su tamaño es de 2 caracteres, el SQL Server tipo de la expresión de acceso de campo es de tamaño 2, pero las asignaciones en el campo no están restringidas por esta faceta.

En la tabla siguiente se captura la matriz de valores válidos para las distintas propiedades para tipos de campo específicos. En esta tabla, "Y" indica que la propiedad es válida y "N" indica que la propiedad no es válida.

El especificado SqlFacetAttribute debe ser compatible con el tipo de campo. Si la propiedad no es válida, el registro de tipos notificará un error si el usuario especifica un valor no predeterminado para la propiedad. Los valores máximos de Precision las propiedades y Scale son 38. Para la MaxSize propiedad , el valor debe estar en el intervalo de 1-8000 para datos binarios y no Unicode, 1-4000 para datos Unicode o -1. Todos los demás valores no son válidos.

Tipo	IsFixedLength	MaxSize	Precisión	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	Y
UDT insertados	N	N	N	N	Y
String	Y	Y	N	N	Y
Byte[]	Y	Y	N	N	Y
Char[]	Y	Y	N	N	Y
DateTime	N	N	N	S1	N
Decimal	N	N	Y	Y	Y

(1) Si se especifica la escala en un tipo DateTime, el valor se devolverá a Transact-SQL como un tipo DateTime2 con la escala especificada.

Constructores

SqlFacetAttribute()

Atributo opcional en un tipo de valor devuelto de un tipo definido por el usuario (UDT), que se utiliza para anotar el resultado devuelto con información adicional que se puede utilizar en Transact-SQL.

Propiedades

IsFixedLength	Indica si el tipo de valor devuelto del tipo definido por el usuario es de una longitud fija.
IsNullable	Indica si el tipo de valor devuelto del tipo definido por el usuario puede ser null.
MaxSize	Tamaño máximo, en unidades lógicas, del tipo de campo subyacente del tipo definido por el usuario.
Precision	Precisión del tipo de valor devuelto del tipo definido por el usuario.
Scale	Escala del tipo de valor devuelto del tipo definido por el usuario.