Como: Adicionar um método específico de localizador

  • Artigo

Você pode retornar uma instância de entidade única, criando uma Finder específico método. O serviço de conectividade de dados de negócios (BDC) executa o método de localização específico quando um usuário seleciona uma entidade em uma Web Part de dados de negócios ou a lista externa. Para obter mais informações, consulte Criando um modelo de conectividade de dados de negócios.

Para criar um método de localização específico

  1. No designer do BDC, selecione uma entidade. Para obter mais informações sobre como adicionar uma entidade para o designer do BDC em Visual Studio. Para obter mais informações, consulte Como: Adicionar uma entidade a um modelo.

  2. No Exibir menu, clique em Other Windowse em seguida, clique em Detalhes do método BDC.

    O Detalhes do método BDC janela é aberta. Para obter mais informações sobre o Detalhes do método BDC janela, consulte Visão geral de ferramentas de Design do BDC modelo.

  3. No Detalhes do método BDC janela, da Adicionar um método lista suspensa, selecione Criar método específico de localizador.

    Visual Studio adiciona os seguintes elementos ao modelo. Esses elementos aparecem na Detalhes do método BDC janela.

    • Um método.

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

    • Um parâmetro de retorno do método.

    • Um descritor de tipo para cada parâmetro.

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

    Para obter mais informações, consulte Criando um modelo de conectividade de dados de negócios.

  4. Abra o Visual Studio Propriedades janela.

  5. Configure o descritor de tipo de parâmetro de retorno como um descritor de tipo de entidade. Para obter mais informações sobre como criar um descritor de tipo de entidade, consulte Como: Definir o descritor de tipo de um parâmetro.

    ObservaçãoObservação

    Não é necessário realizar essa etapa, se você tiver adicionado um método localizador para a entidade. Visual Studio usa o descritor de tipo que você definiu no método Finder.
    ObservaçãoObservação

    Se o campo identificador de tipo de entidade representa um campo em uma tabela de banco de dados que é gerado automaticamente, defina a somente leitura a propriedade do campo identificador para True.

  6. No Detalhes do método janela, selecione a instância de método do método.

    Por padrão, esse método de nomes de Visual Studio MethodInstance1.

  7. No A janela de propriedades, defina a Retornar o nome do parâmetro propriedade para o nome do parâmetro de retorno do método. Para obter mais informações sobre propriedades de método de instância, consulte MethodInstance.

  8. Em Solution Explorer, o arquivo do código de serviço que foi gerado para a entidade com o botão direito e, em seguida, clique em Exibir código.

    O arquivo de código de serviço de entidade abre no Editor de código. Para obter mais informações sobre o arquivo de código de serviço da entidade, consulte Criando um modelo de conectividade de dados de negócios.

  9. Adicione código ao método Finder específico. Este código irá executar as seguintes tarefas:

    • Recupere um registro de uma fonte de dados.

    • Retorne a uma entidade para o serviço do BDC.

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

    ObservaçãoObservação

    Substitua o valor da ServerName campo com o nome do servidor.

    		 
    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

    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;
}

Consulte também

Tarefas

Como: Adicionar um método localizador

Como: Adicionar um método criador

Como: Adicionar um método Deleter

Como: Adicionar um método Updater

Como: Adicionar um parâmetro para um método.

Como: Definir um instância de método

Conceitos

Visão geral de ferramentas de Design do BDC modelo

Outros recursos

Criando um modelo de conectividade de dados de negócios