SqlFacetAttribute SqlFacetAttribute SqlFacetAttribute SqlFacetAttribute Class

Definición

Anota el resultado devuelto de un tipo definido por el usuario (UDT) con información adicional que se puede utilizar en 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.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)]
public class SqlFacetAttribute : Attribute
type SqlFacetAttribute = class
    inherit Attribute
Public Class SqlFacetAttribute
Inherits Attribute
Herencia
SqlFacetAttributeSqlFacetAttributeSqlFacetAttributeSqlFacetAttribute
Atributos

Comentarios

SqlFacetAttributesolo se puede especificar en valores devueltos que no sean void.SqlFacetAttribute may only be specified on non-void return values.

SqlFacetAttributesolo se usa para obtener información sobre el tipo de valor devuelto y no pretende ser una especificación de restricción sobre lo que se puede almacenar en el tipo.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. Por lo tanto, si un campo SqlFacetAttribute tiene un que indica que su tamaño va a tener 2 caracteres, el tipo de SQL Server de la expresión de acceso de campo es de tamaño 2, pero esta faceta no restringe las asignaciones en el campo.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.

En la tabla siguiente se captura la matriz de valores válidos para las distintas propiedades de tipos de campo específicos.The table below captures the matrix of valid values for the various properties for specific field types. En esta tabla, "Y" indica que la propiedad es válida y "N" indica que la propiedad no es válida.In this table, "Y" indicates that the property is valid, and "N" indicates that the property is not valid.

El especificado SqlFacetAttribute debe ser compatible con el tipo de campo.The specified SqlFacetAttribute must be compatible with the field type. Si la propiedad no es válida, el registro de tipo notificará un error si el usuario especifica un valor no predeterminado para la propiedad.If the property is not valid, type registration will report an error if the user specifies a non-default value for the property. Los valores máximos Precision de Scale las propiedades y son 38.The maximum values for Precision and Scale properties are 38. En el MaxSize caso de la propiedad, el valor debe estar en el intervalo de 1-8000 para datos binarios y no Unicode, 1-4000 para datos Unicode, o-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. Los demás valores no son válidos.All other values are not valid.

TipoType IsFixedLengthIsFixedLength MaxSizeMaxSize PrecisiónPrecision EscalaScale IsNullableIsNullable
SqlBoolean NN NN NN NN YY
SqlByte NN NN NN NN YY
SqlInt16 NN NN NN NN YY
SqlInt32 NN NN NN NN YY
SqlInt64 NN NN NN NN YY
SqlSingle NN NN NN NN YY
SqlDouble NN NN NN NN YY
SqlDateTime NN NN NN NN YY
SqlMoney NN NN NN NN YY
SqlGuid NN NN NN NN YY
SqlDecimal NN NN YY YY YY
SqlString YY YY NN NN YY
SqlBinary YY YY NN NN YY
SqlXml NN NN NN NN YY
SqlBytes YY YY NN NN YY
SqlChars YY YY NN NN YY
UDT incrustadosEmbedded UDTs NN NN NN NN YY
String YY YY NN NN YY
Byte[]Byte[] YY YY NN NN YY
Char[]Char[] YY YY NN NN YY
DateTime NN NN NN Y1Y1 NN
Decimal NN NN YY YY YY

(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.(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.

Constructores

SqlFacetAttribute() SqlFacetAttribute() SqlFacetAttribute() 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.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.

Propiedades

IsFixedLength IsFixedLength IsFixedLength IsFixedLength

Indica si el tipo de valor devuelto del tipo definido por el usuario es de una longitud fija.Indicates whether the return type of the user-defined type is of a fixed length.

IsNullable IsNullable IsNullable IsNullable

Indica si el tipo de valor devuelto del tipo definido por el usuario puede ser null.Indicates whether the return type of the user-defined type can be null.

MaxSize MaxSize MaxSize MaxSize

Tamaño máximo, en unidades lógicas, del tipo de campo subyacente del tipo definido por el usuario.The maximum size, in logical units, of the underlying field type of the user-defined type.

Precision Precision Precision Precision

Precisión del tipo de valor devuelto del tipo definido por el usuario.The precision of the return type of the user-defined type.

Scale Scale Scale Scale

Escala del tipo de valor devuelto del tipo definido por el usuario.The scale of the return type of the user-defined type.

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Métodos

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

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

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

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.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)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.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()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_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)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.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)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.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)

Recupera el número de interfaces de información de tipo que proporciona un objeto (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)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a