Adicionar um método Finder específico

Você pode retornar uma única instância de entidade criando um método Finder Específico. O serviço BDC (Business Data Connectivity) executa o método Finder Específico quando um usuário escolhe uma entidade em uma parte da Web dados corporativos ou uma lista externa. Para obter mais informações, confira Criar um modelo de conectividade de dados corporativos.

Para criar um método Finder específico

1. No Designer BDC, escolha uma entidade.

   Para obter informações sobre como adicionar uma entidade ao BDC Designer no Visual Studio, consulte Como adicionar uma entidade a um modelo.

2. Na barra de menus, escolha Exibir>Outras Janelas, Detalhes do Método BDC.

   A janela Detalhes do Método BDC é aberta. Para obter mais informações sobre essa janela, confira Visão geral das ferramentas de design de modelo do BDC.

3. Na lista Adicionar um Método, escolha Criar Método Finder Específico.

   O Visual Studio adiciona os elementos a seguir ao modelo. Esses elementos aparecem na janela Detalhes do Método BDC.

   • Um método.

   • Um parâmetro de entrada para o método.

   • Um parâmetro de retorno para o método.

   • O descritor de tipo para cada parâmetro.

   • Uma instância de método para o método.

     Para obter mais informações, confira Criar um modelo de conectividade de dados corporativos.

4. Abra a janela Propriedades do Visual Studio.

5. Configure o descritor de tipo do parâmetro return como um descritor de tipo de entidade. Para obter informações sobre como criar um descritor de tipo de entidades, consulte Como definir o descritor de tipo de um parâmetro.

   Observação

   Você não precisará executar esta etapa se tiver adicionado um método Finder à entidade. O Visual Studio usa o descritor de tipo que você definiu no método Finder.

   Observação

   Se o campo identificador do tipo de entidade representar um campo em uma tabela de banco de dados gerada automaticamente, defina a propriedade Somente leitura do campo identificador como True.

6. Na janela Detalhes do Método, escolha a instância de método do método.

7. Na Janela Propriedades, defina a propriedade Nome do Parâmetro de Retorno como o nome do parâmetro de retorno do método. Para obter mais informações sobre as propriedades da instância do método, consulte MethodInstance.

8. No Gerenciador de Soluções, abra o menu de atalho do arquivo de código do serviço que foi gerado para a entidade e escolha Exibir Código.

   O arquivo de código do servidor é aberto no Editor de Códigos. Para obter mais informações sobre o arquivo de código do serviço da entidade, confira Criar um modelo de conectividade de dados corporativos.

9. Adicione código ao método Finder Específico. Esse código executa as seguintes tarefas:

   • Recupera um registro de uma fonte de dados.

   • Retorna uma entidade para o serviço BDC.

     O exemplo a seguir retorna um contato do banco de dados de exemplo AdventureWorks para SQL Server.

     Observação

     Substitua o valor do campo ServerName pelo nome do servidor.

     C#

     public static Contact ReadItem(int contactID)
     {
         const string ServerName = "MySQLServerName";
         AdventureWorksDataContext dataContext = new AdventureWorksDataContext
               ("Data Source=" + ServerName + ";" +
                "Initial Catalog=AdventureWorks;Integrated Security=True");
     
         Contact Contact =
             (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
              where contacts.ContactID == contactID
              select contacts).Single();
         return Contact;
     }
     

     VB

     Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
         Const ServerName As String = "MySQLServerName"
         Dim dataContext As AdventureWorksDataContext = _
             New AdventureWorksDataContext("Data Source=" & ServerName & _
                 ";Initial Catalog=AdventureWorks;Integrated Security=True")
     
         Dim Contact As Contact = _
             (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
             Where TempContacts.ContactID = contactID _
             Select TempContacts).[Single]()
         Return Contact
     End Function
     

   ---

Conteúdo relacionado

• Projetar um modelo de conectividade de dados corporativos
• Como adicionar um método Finder
• Como adicionar um método Creator
• Como adicionar um método Deleter
• Como adicionar um método Updater
• Visão geral das ferramentas de design do modelo de BDC
• Como adicionar um parâmetro a um método
• Como definir uma instância de método