Procedura: aggiungere un metodo Finder specifico

È possibile restituire una sola istanza di entità creando un metodo Finder specifico. Il servizio di integrazione applicativa dei dati esegue il metodo Finder specifico quando un utente seleziona un'entità in una web part di integrazione applicativa dei dati o in un elenco esterno. Per ulteriori informazioni, vedere Progettazione di un modello di integrazione applicativa dei dati.

Per creare un metodo Finder specifico

1. Nella finestra di progettazione dell'integrazione applicativa dei dati selezionare un'entità. Per ulteriori informazioni sull'aggiunta di un'entità alla finestra di progettazione dell'integrazione applicativa dei dati in Visual Studio, vedere Procedura: aggiungere un'entità al modello.

2. Scegliere Altre finestre dal menu Visualizza, quindi Dettagli metodo di integrazione applicativa dei dati.

   Verrà visualizzata la finestra Dettagli metodo di integrazione applicativa dei dati. Per ulteriori informazioni sulla finestra Dettagli metodo di integrazione applicativa dei dati, vedere Panoramica degli strumenti di progettazione del modello di integrazione applicativa dei dati.

3. Nella finestra Dettagli metodo di integrazione applicativa dei dati selezionare Crea metodo Finder specifico dall'elenco a discesa Aggiungi metodo.

   In Visual Studio vengono aggiunti gli elementi seguenti al modello. Questi elementi vengono visualizzati nella finestra Dettagli metodo di integrazione applicativa dei dati.

   • Metodo.

   • Parametro di input per il metodo.

   • Parametro restituito per il metodo.

   • Descrittore di tipo per ogni parametro.

   • Istanza di metodo per il metodo.

   Per ulteriori informazioni, vedere Progettazione di 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 di tipo di entità. Per ulteriori informazioni su come creare un descrittore di tipo 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à. In Visual Studio viene utilizzato il descrittore di tipo definito nel metodo Finder.

   Nota

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

6. Nella finestradei dettagli del metodo selezionare l'istanza metodo del metodo.

   Per impostazione predefinita, in Visual Studio viene assegnato il nome MethodInstance1 a questo metodo.

7. Nella finestra Proprietà impostare la proprietà Nome parametro restituito sul nome del parametro restituito del metodo. Per ulteriori informazioni sulle proprietà delle istanze di metodo, vedere MethodInstance (la pagina potrebbe essere in inglese).

8. In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice servizio generato per l'entità, quindi scegliere Visualizza codice.

   Il file di codice servizio dell'entità verrà aperto nell'editor di codice. Per ulteriori informazioni sul file di codice servizio dell'entità, vedere Creazione di un modello di integrazione applicativa dei dati.

9. Aggiungere codice al metodo Finder specifico. Mediante questo codice verranno effettuate le seguenti attività:

   • Recupero di un record da un'origine dati.

   • Restituzione di un'entità al servizio di integrazione applicativa dei dati.

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

   Nota

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

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

Vedere anche

Attività

Procedura: aggiungere un metodo Finder

Procedura: aggiungere un metodo Creator

Procedura: aggiungere un metodo Deleter

Procedura: aggiungere un metodo Updater

Procedura: aggiungere un parametro a un metodo

Procedura: definire un'istanza di metodo

Concetti

Panoramica degli strumenti di progettazione del modello di integrazione applicativa dei dati

Altre risorse

Progettazione di un modello di integrazione applicativa dei dati