Aggiungere un metodo finder specifico

È possibile restituire una singola istanza di entità creando un metodo Finder specifico. Il servizio Business Data Connessione ivity (BDC) esegue il metodo Finder specifico quando un utente sceglie un'entità in una web part dati business o in un elenco esterno. Per altre informazioni, vedere Progettare un modello di integrazione applicativa dei dati.

Per creare un metodo di Finder specifico

1. In Progettazione cluster Big Data scegliere un'entità.

   Per informazioni su come aggiungere un'entità alla finestra di progettazione BDC in Visual Studio, vedere Procedura: Aggiungere un'entità a un modello.

2. Sulla barra dei menu scegliere Visualizza>altre finestre, Dettagli metodo BDC.

   Verrà visualizzata la finestra Dettagli metodo BDC. Per altre informazioni su tale finestra, vedere Panoramica degli strumenti di progettazione del modello BDC.

3. Nell'elenco Aggiungi un metodo scegliere Crea metodo di ricerca specifico.

   Visual Studio aggiunge gli elementi seguenti al modello. Questi elementi vengono visualizzati nella finestra Dettagli metodo BDC.

   • Un metodo.

   • Parametro di input per il metodo .

   • Parametro restituito per il metodo .

   • Descrittore di tipo per ogni parametro.

   • Istanza del metodo .

     Per altre informazioni, vedere Progettare un modello di integrazione applicativa dei dati.

4. Aprire la finestra Proprietà di Visual Studio.

5. Configurare il descrittore di tipo del parametro restituito come descrittore del tipo di entità. Per informazioni su come creare un descrittore di tipi di entità, vedere Procedura: Definire il descrittore di tipo di un parametro.

   Nota

   Non è necessario eseguire questo passaggio se è stato aggiunto un metodo Finder all'entità. Visual Studio usa il descrittore di tipo definito nel metodo Finder.

   Nota

   Se il campo identificatore del tipo di entità rappresenta un campo in una tabella di database generata automaticamente, impostare la proprietà Di sola lettura del campo identificatore su True.

6. Nella finestra Dettagli metodo scegliere l'istanza del metodo .

7. Nella finestra Proprietà impostare la proprietà Return Parameter Name sul nome del parametro restituito del metodo. Per altre informazioni sulle proprietà dell'istanza del metodo, vedere MethodInstance.

8. In Esplora soluzioni aprire il menu di scelta rapida del file di codice del servizio generato per l'entità e quindi scegliere Visualizza codice.

   Il file di codice del servizio entità viene aperto nell'editor di codice. Per altre informazioni sul file di codice del servizio entità, vedere Creare un modello di integrazione applicativa dei dati.

9. Aggiungere codice al metodo Finder specifico. Il codice esegue queste operazioni:

   • Recupera un record da un'origine dati.

   • Restituisce un'entità al servizio BDC.

     Nell'esempio seguente viene restituito un contatto dal database di esempio AdventureWorks per SQL Server.

     Nota

     Sostituire il valore del ServerName campo con il nome del server.

     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
     

   ---

Contenuto correlato

• Progettare un modello di integrazione applicativa dei dati
• Procedura: Aggiungere un metodo Finder
• Procedura: Aggiungere un metodo Creator
• Procedura: Aggiungere un metodo Deleter
• Procedura: Aggiungere un metodo Updater
• Panoramica degli strumenti di progettazione dei modelli BDC
• Procedura: Aggiungere un parametro a un metodo
• Procedura: Definire un'istanza del metodo