Adición de un método Finder específico

Puede devolver una sola instancia de entidad creando un método Finder específico. El servicio Conectividad a datos profesionales (BDC) ejecuta el método Finder específico cuando un usuario elige una entidad en un elemento web de datos profesionales o una lista externa. Para obtener más información, vea Diseño de un modelo de conectividad a datos profesionales.

Creación de un método Finder específico

1. En el Diseñador de BDC, elija una entidad.

   Para obtener información sobre cómo agregar una entidad al Diseñador de BDC en Visual Studio, vea Procedimientos para agregar una entidad a un modelo.

2. En la barra de menús, elija Ver>otras ventanas, Detalles del método de BDC.

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

3. En la lista Agregar un método, elija Crear método Finder específico.

   Visual Studio agrega los elementos siguientes al modelo. Estos elementos aparecen en la ventana Detalles del método de BDC.

   • Un método

   • Un parámetro de entrada para el método.

   • Un parámetro devuelto para el método.

   • Un descriptor de tipo para cada parámetro.

   • Una instancia de método para el método.

     Para obtener más información, vea Diseño de un modelo de conectividad a datos profesionales.

4. Abra la ventana Propiedades de Visual Studio.

5. Configure el descriptor de tipo del parámetro devuelto como descriptor de tipo de entidad. Para obtener información sobre cómo crear un descriptor de tipo de entidad, vea Procedimientos para definir el descriptor de tipo de un parámetro.

   Nota

   No es necesario realizar este paso si ha agregado un método Finder a la entidad. Visual Studio usa el descriptor de tipo que definió en el método Finder.

   Nota

   Si el campo de identificador del tipo de entidad representa un campo de una tabla de base de datos que se genera automáticamente, establezca la propiedad de solo lectura del campo de identificador en True.

6. En la ventalla Detalles del método, elija la instancia de método del método.

7. En la ventana Propiedades, establezca la propiedad Nombre del parámetro de devolución en el nombre del parámetro devuelto del método. Para obtener más información sobre las propiedades de la instancia de método, vea Instancia de método.

8. En el Explorador de soluciones, abra el menú contextual del archivo de código de servicio que se generó para la entidad y, después, elija Ver código.

   El archivo de código de servicio de la entidad se abre en el Editor de código. Para obtener más información sobre el archivo de código de servicio de la entidad, vea Creación de un modelo de conectividad a datos empresariales.

9. Agregue código al método Finder específico. Este código realiza las tareas siguientes:

   • Recupera un registro de un origen de datos.

   • Devuelve una entidad al servicio BDC.

     En el ejemplo siguiente se devuelve un contacto de la base de datos de ejemplo AdventureWorks para SQL Server.

     Nota

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

     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
     

   ---

Contenido relacionado

• Diseño de un modelo de conectividad a datos profesionales
• Procedimientos para agregar un método Finder
• Procedimientos para agregar un método Creator
• Procedimiento: Incorporación de un método Deleter
• Procedimientos para agregar un método Updater
• Información general sobre las herramientas de diseño del modelo BDC
• Cómo: Agregar un parámetro a un método
• Cómo: Definir la instancia de un método