Partilhar via


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

Você pode retornar uma única instância de entidade criando um método específico de localizador .O serviço de (BDC) de conectividade de dados comerciais executa o método específico de localizador quando um usuário escolher uma entidade na parte Web de dados comerciais ou em uma lista externo.Para mais informações, consulte Elaborar um modelo de conectividade de dados de negócios.

Para criar um método específico de localizador

  1. Em o designer de BDC, escolha uma entidade.

    Para obter informações sobre como adicionar uma entidade o designer de BDC no Visual Studio, consulte Como: adicionar uma entidade a um modelo.

  2. Em a barra de menu, escolha Modo de Visualização, Outras Janelas, Detalhes do método de BDC.

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

  3. Em a lista de Adicione um método , escolha Crie o método específico de localizador.

    O Visual Studio adiciona os seguintes elementos para o modelo.Esses elementos aparecem na janela de Detalhes do método de BDC .

    • Um método.

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

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

    • Um descritor de tipo para cada parâmetro.

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

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

  4. Abra a janela do Visual Studio Propriedades .

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

    ObservaçãoObservação

    Você não precisa executar esta etapa se você adicionou um método de localizador para a entidade.O Visual Studio usa o descritor do tipo que você definiu no método do localizador.

    ObservaçãoObservação

    Se o campo identificador de tipo de objeto representa um campo em uma tabela de banco de dados que é gerada automaticamente, defina a propriedade de Somente leitura do campo identificador a True.

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

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

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

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

  9. Adicione código ao método específico de localizador.Esse código executa as seguintes tarefas:

    • Recupera um registro de uma fonte de dados.

    • Retorna um objeto para o serviço de BDC.

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

    ObservaçãoObservação

    Substitua o valor do campo de ServerName 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

Elaborar um modelo de conectividade de dados de negócios