Asignación basada en atributos
LINQ to SQL asigna una base de datos de SQL Server a un modelo de objetos de LINQ to SQL aplicando atributos o utilizando un archivo de asignación externo. En este tema se describe el enfoque basado en atributos.
En su forma más elemental, LINQ to SQL asigna una base de datos a un DataContext, una tabla a una clase y las columnas y relaciones a las propiedades de esas clases. También puede utilizar atributos para asignar una jerarquía de herencia en su modelo de objetos. Para obtener más información, veaCómo: Generar el modelo de objetos en Visual Basic o C#.
Normalmente, los desarrolladores que usan Visual Studio realizan la asignación basada en atributos mediante el Object Relational Designer. También puede usar la herramienta de la línea de comandos de SQLMetal o incluir los atributos en el código manualmente. Para obtener más información, veaCómo: Generar el modelo de objetos en Visual Basic o C#.
Nota
También puede realizar la asignación utilizando un archivo XML externo. Para más información, vea Asignación externa.
En las secciones siguientes se describe con más detalle la asignación basada en atributos. Para obtener más información, vea el espacio de nombres System.Data.Linq.Mapping.
Atributo DatabaseAttribute
Utilice este atributo para especificar el nombre predeterminado de la base de datos cuando la conexión no proporciona ningún nombre. Este atributo es opcional, pero, si lo utiliza, debe aplicar la propiedad Name, como se indica en la tabla siguiente.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| Name | String | Vea Name. | Cuando se usa con su propiedad Name, especifica el nombre de la base de datos. |
Para más información, consulte DatabaseAttribute.
Atributo TableAttribute
Utilice este atributo para designar una clase como una clase de entidad que está asociada a una tabla o vista de base de datos. LINQ to SQL trata las clases que tienen este atributo como clases persistentes. En la tabla siguiente se describe la propiedad Name.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| Name | String | La misma cadena que el nombre de clase | Designa una clase como una clase de entidad que está asociada a una tabla de base de datos. |
Para más información, consulte TableAttribute.
Atributo ColumnAttribute
Utilice este atributo para designar un miembro de una clase de entidad para que represente una columna de una tabla de base de datos. Este atributo se puede aplicar cualquier campo o propiedad.
Solo los miembros que identifique como columnas se recuperarán y conservarán cuando LINQ to SQL guarde los cambios en la base de datos. Se supone que los miembros que no tienen este atributo no son persistentes y no se envían para operaciones de inserción o actualización.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| AutoSync | AutoSync | Nunca | Indica a Common Language Runtime (CLR) que recupere el valor después de una operación de inserción o actualización. Opciones: Always, Never, OnUpdate, OnInsert. |
| CanBeNull | Boolean | true |
Indica que una columna puede contener valores nulos. |
| DbType | String | Tipo de columna de base de datos deducido | Utiliza tipos de base de datos y modificadores para especificar el tipo de la columna de base de datos. |
| Expression | String | Vacío | Define una columna calculada en una base de datos. |
| IsDbGenerated | Boolean | false |
Indica que una columna contiene valores que la base de datos genera automáticamente. |
| IsDiscriminator | Boolean | false |
Indica que la columna contiene un valor de discriminador para una jerarquía de herencia de LINQ to SQL. |
| IsPrimaryKey | Boolean | false |
Especifica que este miembro de clase representa una columna que es o forma parte de las claves principales de la tabla. |
| IsVersion | Boolean | false |
Identifica el tipo de columna del miembro como una marca de tiempo o número de versión de la base de datos. |
| UpdateCheck | UpdateCheck | Always, a menos que IsVersion sea true para un miembro |
Especifica cómo se plantea LINQ to SQL la detección de conflictos de simultaneidad optimista. |
Para más información, consulte ColumnAttribute.
Nota
Los valores de propiedad AssociationAttribute y ColumnAttribute Storage distinguen entre mayúsculas y minúsculas. Por ejemplo, asegúrese de que los valores utilizados en el atributo de la propiedad AssociationAttribute.Storage coinciden con el uso de mayúsculas y minúsculas para los nombres de propiedad correspondientes del resto del código. Esto se aplica a todos los lenguajes de programación de .NET, incluso a los que típicamente no distinguen entre mayúsculas y minúsculas, como Visual Basic. Para obtener más información acerca de la propiedad Storage, vea DataAttribute.Storage.
Atributo AssociationAttribute
Utilice este atributo para designar una propiedad que represente una asociación en la base de datos, como una relación entre clave externa y clave principal. Para obtener más información acerca de las relaciones, consulte Cómo: Asignar relaciones de bases de datos.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| DeleteOnNull | Boolean | false |
Cuando se coloca en una asociación cuyos miembros de clave externa no aceptan valores Null, elimina el objeto cuando la asociación está establecida en null. |
| DeleteRule | String | None | Agrega comportamiento de eliminación a una asociación. |
| IsForeignKey | Boolean | false |
Si es verdadero, designa el miembro como la clave externa de una asociación que representa una relación de base de datos. |
| IsUnique | Boolean | false |
Si es verdadero, indica una restricción de unicidad en la clave externa. |
| OtherKey | String | Identificador de la clase relacionada | Designa uno o más miembros de la clase de entidad de destino como valores de clave en el otro lado de la asociación. |
| ThisKey | String | Identificador de la clase contenedora | Designa miembros de esta clase de entidad para que representen los valores de clave en este lado de la asociación. |
Para obtener más información, vea AssociationAttribute.
Nota
Los valores de propiedad AssociationAttribute y ColumnAttribute Storage distinguen entre mayúsculas y minúsculas. Por ejemplo, asegúrese de que los valores utilizados en el atributo de la propiedad AssociationAttribute.Storage coinciden con el uso de mayúsculas y minúsculas para los nombres de propiedad correspondientes del resto del código. Esto se aplica a todos los lenguajes de programación de .NET, incluso a los que típicamente no distinguen entre mayúsculas y minúsculas, como Visual Basic. Para obtener más información acerca de la propiedad Storage, vea DataAttribute.Storage.
Atributo InheritanceMappingAttribute
Utilice este atributo para asignar una jerarquía de herencia.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| Code | String | Ninguno. El valor debe suministrarse. | Especifica el valor de código del discriminador. |
| IsDefault | Boolean | false |
Si es verdadero, crea instancias de un objeto de este tipo cuando ningún valor de discriminador del almacén coincide con ninguno de los valores especificados. |
| Type | Tipo | Ninguno. El valor debe suministrarse. | Especifica el tipo de la clase en la jerarquía. |
Para más información, consulte InheritanceMappingAttribute.
Atributo FunctionAttribute
Utilice este atributo para designar un método para representar un procedimiento almacenado o una función definida por el usuario en la base de datos.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| IsComposable | Boolean | false |
Si es falso, indica la asignación a un procedimiento almacenado. Si es verdadero, indica la asignación a una función definida por el usuario. |
| Name | String | La misma cadena que el nombre en la base de datos | Especifica el nombre del procedimiento almacenado o la función definida por el usuario. |
Para más información, consulte FunctionAttribute.
Atributo ParameterAttribute
Utilice este atributo para asignar parámetros de entrada en métodos de procedimiento almacenado.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| DbType | String | None | Especifica el tipo de base de datos. |
| Name | String | La misma cadena que el nombre del parámetro en la base de datos | Especifica un nombre para el parámetro. |
Para obtener más información, vea ParameterAttribute.
Atributo ResultTypeAttribute
Utilice este atributo para especificar un tipo de resultado.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| Type | Tipo | (Ninguna) | Se utiliza en los métodos asignados a los procedimientos almacenados que devuelven IMultipleResults. Declara las asignaciones de tipos válidas o esperadas para el procedimiento almacenado. |
Para obtener más información, vea ResultTypeAttribute.
Atributo DataAttribute
Utilice este atributo para especificar nombres y campos de almacenamiento privados.
En la tabla siguiente se describen las propiedades de este atributo.
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
| Name | String | Igual que el nombre en la base de datos | Especifica el nombre de la tabla, columna, etc. |
| Storage | String | Descriptores de acceso públicos | Especifica el nombre del campo de almacenamiento subyacente. |
Para obtener más información, vea DataAttribute.