Compartilhar via

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

Em sua forma mais elementar, LINQ to SQL mapeia um banco de dados para um DataContext, uma tabela para uma classe e colunas e relações com 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 no Visual Basic ou C#.

Os desenvolvedores que usam o Visual Studio normalmente executam mapeamento baseado em atributo usando o Designer Relacional de Objetos. Você também pode usar a ferramenta de linha de comando SQLMetal ou pode codificar manualmente os atributos por conta própria. Para obter mais informações, consulte Como gerar o modelo de objeto no Visual Basic ou C#.

Observação

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, você deve aplicar a Name propriedade, conforme descrito na tabela a seguir.

Propriedade Tipo Padrão Descrição
Name fio Consulte Name Usado com sua Name propriedade, especifica o nome do banco de dados.

Para obter mais informações, consulte 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 classes que têm esse atributo como classes persistentes. A tabela a seguir descreve a Name propriedade.

Propriedade Tipo Padrão Descrição
Name fio 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, consulte 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 que você identifica como colunas são recuperados e persistidos quando LINQ to SQL salva 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 Tipo Padrão Descrição
AutoSync AutoSsíncrono Nunca Instrui o CLR (Common Language Runtime) a recuperar o valor após uma operação de inserção ou atualização.

Opções: Always, Never, OnUpdate, OnInsert.
CanBeNull Booliano true Indica que uma coluna pode conter valores nulos.
DbType fio Tipo de coluna de banco de dados inferido Usa tipos de banco de dados e modificadores para especificar o tipo da coluna de banco de dados.
Expression fio Vazio Define uma coluna computada em um banco de dados.
IsDbGenerated Booliano false Indica que uma coluna contém valores gerados automaticamente pelo banco de dados.
IsDiscriminator Booliano false Indica que a coluna contém um valor de discriminador para uma hierarquia de herança do LINQ to SQL.
IsPrimaryKey Booliano false Especifica que este membro da classe representa uma coluna que é ou faz parte das chaves primárias da tabela.
IsVersion Booliano 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 detecta conflitos de concorrência otimista.

Para obter mais informações, consulte ColumnAttribute.

Observação

Os valores de propriedade de armazenamento AssociationAttribute e ColumnAttribute diferenciam maiúsculas de minúsculas. Por exemplo, verifique se os valores usados no atributo para a propriedade AssociationAttribute.Storage correspondem ao caso dos nomes de propriedade correspondentes usados em outro lugar no código. Isso se aplica a todas as linguagens de programação do .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 Tipo Padrão Descrição
DeleteOnNull Booliano 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 fio Nenhum Adiciona o comportamento de exclusão a uma associação.
IsForeignKey Booliano false Se for true, designa o membro como a chave estrangeira em uma associação que representa uma relação de banco de dados.
IsUnique Booliano false Se verdadeiro, indica uma restrição de exclusividade na chave estrangeira.
OtherKey fio ID da classe relacionada Designa um ou mais membros da classe de entidade de destino como valores chave no outro lado da associação.
ThisKey fio ID da classe que contém Designa membros dessa classe de entidade para representar os valores principais desse lado da associação.

Para obter mais informações, consulte AssociationAttribute.

Observação

Os valores de propriedade de armazenamento AssociationAttribute e ColumnAttribute diferenciam maiúsculas de minúsculas. Por exemplo, verifique se os valores usados no atributo para a propriedade AssociationAttribute.Storage correspondem ao caso dos nomes de propriedade correspondentes usados em outro lugar no código. Isso se aplica a todas as linguagens de programação do .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 Tipo Padrão Descrição
Code fio Nenhum. O valor deve ser fornecido. Especifica o valor do código do discriminador.
IsDefault Booliano false Se for verdadeiro, instancia objeto desse tipo quando nenhum valor de discriminador no repositório coincide com nenhum dos valores especificados.
Type Tipo Nenhum. O valor deve ser fornecido. Especifica o tipo da classe na hierarquia.

Para obter mais informações, consulte 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 Tipo Padrão Descrição
IsComposable Booliano false Se for falso, indica o mapeamento para um procedimento armazenado. Se verdadeiro, indica o mapeamento para uma função definida pelo usuário.
Name fio 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, consulte FunctionAttribute.

Atributo ParameterAttribute

Use esse atributo para mapear parâmetros de entrada em métodos de procedimento armazenados.

A tabela a seguir descreve as propriedades desse atributo.

Propriedade Tipo Padrão Descrição
DbType fio Nenhum Especifica o tipo de banco de dados.
Name fio 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, consulte ParameterAttribute.

Atributo ResultTypeAttribute

Use esse atributo para especificar um tipo de resultado.

A tabela a seguir descreve as propriedades desse atributo.

Propriedade Tipo Padrão Descrição
Type Tipo (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, consulte ResultTypeAttribute.

Atributo DataAttribute

Use esse atributo para especificar nomes e campos de armazenamento privados.

A tabela a seguir descreve as propriedades desse atributo.

Propriedade Tipo Padrão Descrição
Name fio Mesmo nome no banco de dados Especifica o nome da tabela, coluna e assim por diante.
Storage fio Acessadores públicos Especifica o nome do campo de armazenamento subjacente.

Para obter mais informações, consulte DataAttribute.

Consulte também

  • Last updated on