Mapeamento baseado em atributos
O LINQ to SQL mapeia um banco de dados do SQL Server para um modelo de objeto LINQ to SQL aplicando atributos ou usando um arquivo de mapeamento externo. Este tópico descreve a abordagem baseada em atributos.
Em sua forma mais elementar, o LINQ to SQL mapeia um banco de dados para um DataContext, uma tabela para uma classe e colunas e relações para propriedades nessas classes. Você também pode usar atributos para mapear uma hierarquia de herança em seu modelo de objeto. Para obter mais informações, consulte Como gerar o modelo de objeto em Visual Basic ou C#.
Os desenvolvedores que usam o Visual Studio normalmente executam o mapeamento baseado em atributos usando o Object Relational Designer. Você também pode usar a ferramenta de linha de comando SQLMetal ou você mesmo pode codificar manualmente os atributos. Para obter mais informações, consulte Como gerar o modelo de objeto em Visual Basic ou C#.
Nota
Você também pode mapear usando um arquivo XML externo. Para obter mais informações, consulte Mapeamento externo.
As seções a seguir descrevem o mapeamento baseado em atributos com mais detalhes. Para obter mais informações, consulte o System.Data.Linq.Mapping namespace.
Atributo DatabaseAttribute
Use esse atributo para especificar o nome padrão do banco de dados quando um nome não for fornecido pela conexão. Esse atributo é opcional, mas se você usá-lo, deverá aplicar a Name propriedade, conforme descrito na tabela a seguir.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| Name | String | Veja Name | Usado com sua Name propriedade, especifica o nome do banco de dados. |
Para obter mais informações, veja DatabaseAttribute.
Atributo TableAttribute
Use esse atributo para designar uma classe como uma classe de entidade associada a uma tabela ou exibição de banco de dados. O LINQ to SQL trata as classes que têm esse atributo como classes persistentes. A tabela a seguir descreve a Name propriedade.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| Name | String | Mesma cadeia de caracteres que o nome da classe | Designa uma classe como uma classe de entidade associada a uma tabela de banco de dados. |
Para obter mais informações, veja TableAttribute.
Atributo ColumnAttribute
Use esse atributo para designar um membro de uma classe de entidade para representar uma coluna em uma tabela de banco de dados. Você pode aplicar esse atributo a qualquer campo ou propriedade.
Somente os membros identificados como colunas são recuperados e persistem quando o LINQ to SQL salva as alterações no banco de dados. Os membros sem esse atributo são considerados não persistentes e não são enviados para inserções ou atualizações.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| AutoSync | Sincronização Automática | Nunca | Instrui o Common Language Runtime (CLR) a recuperar o valor após uma operação de inserção ou atualização. Opções: Always, Never, OnUpdate, OnInsert. |
| CanBeNull | Boolean | true |
Indica que uma coluna pode conter valores nulos. |
| DbType | String | Tipo de coluna de banco de dados inferido | Usa tipos de banco de dados e modificadores para especificar o tipo da coluna do banco de dados. |
| Expression | String | Vazio | Define uma coluna computada em um banco de dados. |
| IsDbGenerated | Boolean | false |
Indica que uma coluna contém valores que o banco de dados gera automaticamente. |
| IsDiscriminator | Boolean | false |
Indica que a coluna contém um valor discriminador para uma hierarquia de herança LINQ to SQL. |
| IsPrimaryKey | Boolean | false |
Especifica que esse membro da classe representa uma coluna que é ou faz parte das chaves primárias da tabela. |
| IsVersion | Boolean | false |
Identifica o tipo de coluna do membro como um carimbo de data/hora ou número de versão do banco de dados. |
| UpdateCheck | UpdateCheck | Always, a menos que IsVersion seja true para um membro |
Especifica como o LINQ to SQL aborda a deteção de conflitos de simultaneidade otimistas. |
Para obter mais informações, veja ColumnAttribute.
Nota
Os valores das propriedades AssociationAttribute e ColumnAttribute Storage diferenciam maiúsculas de minúsculas. Por exemplo, certifique-se de que os valores usados no atributo para a propriedade AssociationAttribute.Storage correspondam ao caso dos nomes de propriedade correspondentes usados em outro lugar no código. Isso se aplica a todas as linguagens de programação .NET, mesmo aquelas que normalmente não diferenciam maiúsculas de minúsculas, incluindo o Visual Basic. Para obter mais informações sobre a propriedade Storage, consulte DataAttribute.Storage.
Atributo AssociationAttribute
Use esse atributo para designar uma propriedade para representar uma associação no banco de dados, como uma chave estrangeira para a relação de chave primária. Para obter mais informações sobre relações, consulte Como mapear relações de banco de dados.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| DeleteOnNull | Booleano | false |
Quando colocado em uma associação cujos membros de chave estrangeira são todos não anuláveis, exclui o objeto quando a associação é definida como nula. |
| DeleteRule | String | Nenhuma | Adiciona comportamento de exclusão a uma associação. |
| IsForeignKey | Boolean | false |
Se verdadeiro, designa o membro como a chave estrangeira em uma associação que representa uma relação de banco de dados. |
| IsUnique | Boolean | false |
Se verdadeiro, indica uma restrição de exclusividade na chave estrangeira. |
| OtherKey | String | ID da classe relacionada | Designa um ou mais membros da classe de entidade de destino como valores-chave do outro lado da associação. |
| ThisKey | String | ID da classe que contém | Designa membros dessa classe de entidade para representar os valores-chave deste lado da associação. |
Para obter mais informações, veja AssociationAttribute.
Nota
Os valores das propriedades AssociationAttribute e ColumnAttribute Storage diferenciam maiúsculas de minúsculas. Por exemplo, certifique-se de que os valores usados no atributo para a propriedade AssociationAttribute.Storage correspondam ao caso dos nomes de propriedade correspondentes usados em outro lugar no código. Isso se aplica a todas as linguagens de programação .NET, mesmo aquelas que normalmente não diferenciam maiúsculas de minúsculas, incluindo o Visual Basic. Para obter mais informações sobre a propriedade Storage, consulte DataAttribute.Storage.
Atributo InheritanceMappingAttribute
Use esse atributo para mapear uma hierarquia de herança.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| Code | String | Nenhum. O valor deve ser fornecido. | Especifica o valor do código do discriminador. |
| IsDefault | Boolean | false |
Se true, instancia um objeto desse tipo quando nenhum valor discriminador no repositório corresponde a qualquer um dos valores especificados. |
| Type | Type | Nenhum. O valor deve ser fornecido. | Especifica o tipo da classe na hierarquia. |
Para obter mais informações, veja InheritanceMappingAttribute.
Atributo FunctionAttribute
Use esse atributo para designar um método como representando um procedimento armazenado ou uma função definida pelo usuário no banco de dados.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| IsComposable | Booleano | false |
Se false, indica o mapeamento para um procedimento armazenado. Se true, indica o mapeamento para uma função definida pelo usuário. |
| Name | String | Mesma cadeia de caracteres que o nome no banco de dados | Especifica o nome do procedimento armazenado ou da função definida pelo usuário. |
Para obter mais informações, veja FunctionAttribute.
Atributo ParameterAttribute
Use esse atributo para mapear parâmetros de entrada em métodos de procedimento armazenado.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| DbType | String | Nenhuma | Especifica o tipo de banco de dados. |
| Name | String | Mesma cadeia de caracteres que o nome do parâmetro no banco de dados | Especifica um nome para o parâmetro. |
Para obter mais informações, veja ParameterAttribute.
Atributo ResultTypeAttribute
Use este atributo para especificar um tipo de resultado.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| Type | Type | (Nenhum) | Usado em métodos mapeados para procedimentos armazenados que retornam IMultipleResults. Declara os mapeamentos de tipo válidos ou esperados para o procedimento armazenado. |
Para obter mais informações, veja ResultTypeAttribute.
Atributo DataAttribute
Use esse atributo para especificar nomes e campos de armazenamento privado.
A tabela a seguir descreve as propriedades desse atributo.
| Propriedade | Type | Predefinição | Description |
|---|---|---|---|
| Name | String | O mesmo que nome no banco de dados | Especifica o nome da tabela, coluna e assim por diante. |
| Storage | String | Acessos públicos | Especifica o nome do campo de armazenamento subjacente. |
Para obter mais informações, veja DataAttribute.