Adicionar validação a classes de entidade

Validar classes de entidade é o processo de confirmar que os valores inseridos em objetos de dados estão em conformidade com as restrições no esquema de um objeto e também com as regras estabelecidas para o aplicativo. Validar dados antes de enviar atualizações para o banco de dados subjacente é uma boa prática que reduz erros. Também reduz o número potencial de viagens de ida e volta entre uma aplicação e a base de dados.

As ferramentas LINQ to SQL no Visual Studio fornecem métodos parciais que permitem aos usuários estender o código gerado pelo designer que é executado durante Inserções, Atualizações e Exclusões de entidades completas e também durante e após alterações de coluna individuais.

Adicionar validação para alterações ao valor em uma coluna específica

Este procedimento mostra como validar dados quando o valor em uma coluna é alterado. Como a validação é executada dentro da definição de classe (em vez de na interface do usuário), uma exceção é lançada se o valor fizer com que a validação falhe. Implemente o tratamento de erros para o código em seu aplicativo que tenta alterar os valores da coluna.

Para validar dados durante a alteração de valor de uma coluna

1. Abra ou crie um novo arquivo LINQ to SQL Classes (.dbml arquivo) no O/R Designer. (Clique duas vezes no .dbml arquivo no Gerenciador de Soluções.)

2. No O/R Designer, clique com o botão direito do mouse na classe para a qual você deseja adicionar validação e selecione Exibir código.

   O Editor de Códigos é aberto com uma classe parcial para a classe de entidade selecionada.

3. Coloque o cursor na classe parcial.

4. Para projetos Visual Basic:

   1. Expanda a lista Nome do método .

   2. Localize o método OnCOLUMNNAMEChanging para a coluna à qual você deseja adicionar validação.

   3. Um OnCOLUMNNAMEChanging método é adicionado à classe parcial.

   4. Adicione o código a seguir para primeiro verificar se um valor foi inserido e, em seguida, para garantir que o valor inserido para a coluna seja aceitável para seu aplicativo. O value argumento contém o valor proposto, portanto, adicione lógica para confirmar que é um valor válido:

      If value.HasValue Then
          ' Add code to ensure that the value is acceptable.
          ' If value < 1 Then
          '    Throw New Exception("Invalid data!")
          ' End If
      End If
      

   Para projetos C#:

   Como os projetos C# não geram manipuladores de eventos automaticamente, você pode usar o IntelliSense para criar os métodos parciais de alteração de coluna. Digite partial e, em seguida, um espaço para acessar a lista de métodos parciais disponíveis. Clique no método de alteração de coluna para a coluna para a qual você deseja adicionar validação. O código a seguir é semelhante ao código que é gerado quando você seleciona um método parcial de alteração de coluna:

   partial void OnCOLUMNNAMEChanging(COLUMNDATATYPE value)
       {
          throw new System.NotImplementedException();
       }
   

Adicionar validação para atualizações a uma classe de entidade

Além de verificar os valores durante as alterações, você também pode validar dados quando é feita uma tentativa de atualizar uma classe de entidade completa. A validação durante uma tentativa de atualização permite comparar valores em várias colunas se as regras de negócios exigirem isso. O procedimento a seguir mostra como validar quando é feita uma tentativa de atualizar uma classe de entidade completa.

Para validar dados durante uma atualização para uma classe de entidade

1. Abra ou crie um novo arquivo LINQ to SQL Classes (.dbml arquivo) no O/R Designer. (Clique duas vezes no .dbml arquivo no Gerenciador de Soluções.)

2. Clique com o botão direito do mouse em uma área vazia no O/R Designer e clique em View Code.

   O Editor de Códigos é aberto com uma classe parcial para o DataContext.

3. Coloque o cursor na classe parcial do DataContext.

4. Para projetos Visual Basic:

   1. Expanda a lista Nome do método .

   2. Clique em UpdateENTITYCLASSNAME.

   3. Um UpdateENTITYCLASSNAME método é adicionado à classe parcial.

   4. Acesse valores de coluna individuais usando o instance argumento, conforme mostrado no código a seguir:

      If (instance.COLUMNNAME = x) And (instance.COLUMNNAME = y) Then
          Dim ErrorMessage As String = "Invalid data!"
          Throw New Exception(ErrorMessage)
      End If
      

   Para projetos C#:

   Como os projetos C# não geram manipuladores de eventos automaticamente, você pode usar o IntelliSense para criar o método parcial UpdateCLASSNAME . Digite partial e, em seguida, um espaço para acessar a lista de métodos parciais disponíveis. Clique no método de atualização para a classe na qual você deseja adicionar validação. O código a seguir é semelhante ao código que é gerado quando você seleciona um UpdateCLASSNAME método parcial:

   partial void UpdateCLASSNAME(CLASSNAME instance)
   {
       if ((instance.COLUMNNAME == x) && (instance.COLUMNNAME = y))
       {
           string ErrorMessage = "Invalid data!";
           throw new System.Exception(ErrorMessage);
       }
   }
   

Conteúdo relacionado

• Ferramentas LINQ to SQL no Visual Studio
• Validação de dados
• LINQ to SQL (.NET Framework)