Cómo: Agregar un método Finder

Para habilitar el servicio Conectividad de datos profesionales para mostrar una lista de entidades en una lista o elemento web, debe crear un método Finder. Un método Finder es un método especial que devuelve una colección de instancias de entidad. Para obtener más información, vea Diseñar un modelo de conectividad a datos profesionales.

Para crear un método Finder

1. Seleccione una entidad en el diseñador de BDC. Para obtener más información sobre cómo agregar una entidad al diseñador de BDC en Visual Studio, vea Cómo: Agregar una entidad a un modelo.

2. En el menú Ver, haga clic en Otras ventanas y, a continuación, en Detalles del método de BDC.

   Se abre la ventana Detalles del método de BDC. Para obtener más información sobre la ventana Detalles del método de BDC, vea Introducción general a las herramientas de diseño del modelo BDC.

3. En la ventana Detalles del método de BDC, en la lista desplegable Agregar un método, seleccione Crear método Finder.

   Visual Studio agrega un método, un parámetro devuelto y un descriptor de tipos.

4. Configure el descriptor de tipos como un descriptor de tipos de colección de entidades. Para obtener más información sobre cómo crear un descriptor de tipos de colección de entidades, vea Cómo: Definir el descriptor de tipo de un parámetro.

   Nota

   No tiene que seguir este paso si ha agregado un método Finder específico a la entidad. Visual Studio utiliza el descriptor de tipos que definió en el método Finder específico.

5. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el archivo de código de servicio generado para la entidad y, a continuación, haga clic en Ver código. Para obtener más información sobre el archivo de código del servicio, vea Crea un modelo de conectividad a datos profesionales.

6. Agregue código al método Finder. Este código realiza las tareas siguientes:

   • Recupera datos de un origen de datos.

   • Devuelve una lista de entidades al servicio BDC.

   En el siguiente ejemplo se devuelve una colección de entidades Contact utilizando los datos de la base de datos de ejemplo AdventureWorks para SQL Server.

   Nota

   Reemplace el valor del campo ServerName con el nombre del servidor.

   Public Shared Function ReadList() As IEnumerable(Of Contact)
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim Contacts As IEnumerable(Of Contact) = _
           From TempContacts In dataContext.Contacts.Take(20) _
                 Select TempContacts
       Return Contacts
   End Function
   

   public static IEnumerable<Contact> ReadList()
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       IEnumerable<Contact> Contacts =
           from contacts in dataContext.Contacts.Take(20)
           select contacts;
       return Contacts;
   
   }
   

Vea también

Tareas

Cómo: Agregar un método Finder específico

Cómo: Agregar un método Creator

Cómo: Agregar un método Deleter

Cómo: Agregar un método Updater

Cómo: Agregar un parámetro a un método

Cómo: Definir la instancia de un método

Conceptos

Introducción general a las herramientas de diseño del modelo BDC

Otros recursos

Diseñar un modelo de conectividad a datos profesionales