Cómo: Agregar un control personalizado a una pantalla de Silverlight

Artículo
02/19/2013

Puede agregar los controles de Silverlight a una pantalla LightSwitch.Utilizando los controles de Silverlight, se puede mostrar o recopilar información de maneras que exceden las capacidades de los controles LightSwitch integrados.

Puede utilizar los controles que están incluidos en el runtime de Silverlight y el SDK de Silverlight.También puede utilizar los controles que crea con las plantillas de proyecto de Silverlight, por ejemplo, los que están disponibles en Visual Studio 2010.Ambos tipos de controles se conocen como controles personalizados en LightSwitch.

Para obtener información sobre la creación de controles personalizados usando plantillas de proyecto de Silverlight en Visual Studio, vea Control Basics (Silverlight QuickStart).

Agregar nuevos controles y reemplazar controles existentes

Puede agregar un control personalizado a una pantalla, como un nuevo control o como un reemplazo para un control LightSwitch existente.

Para agregar un control personalizado a una pantalla

En el Árbol de contenido de pantalla seleccione un grupo.
En la parte superior del Diseñador de pantallas, haga clic en Agregar elemento de diseño y a continuación, haga clic en Control personalizado.
En el cuadro de diálogo Agregar control personalizado, expanda el nodo de ensamblado, expanda el nodo de espacio de nombres y, a continuación, seleccione el nodo de control.

Si el ensamblado que desea no aparece en el cuadro de diálogo Agregar control personalizado, haga clic en Agregar referencia.En el cuadro de diálogo Agregar referencia, selecciones un ensamblado o proyecto local que contenga el control que desea usar y haga clic en Aceptar.

[!NOTA]

Si el control personalizado utilizando las plantillas de proyectos de Silverlight en Visual Studio, y enlazó el control a los datos modificando el XAML, no tiene que realizar el paso siguiente.Para obtener más información sobre cómo enlazar un control personalizado a los datos modificando el XAML del control, vea Using Custom Controls to Enhance Your LightSwitch Application UI.Si el control personalizado es un control de Silverlight integrado, o si creó este control utilizando las plantillas de proyectos de Silverlight en Visual Studio, pero desea enlazar el control a los datos utilizando LightSwitch, continúe en el paso siguiente.
En el campo Especifique los datos del nuevo control personalizado, escriba el nombre de los datos de la pantalla que desea enlazar al control y, a continuación, haga clic en Aceptar.

Por ejemplo, si desea que un cuadro de lista personalizado muestre los nombres de una colección denominada CustomerSet, escriba CustomerSet.Si desea que el control muestre el nombre del cliente actualmente seleccionado, escriba CustomerSet.SelectedItem.ContactName.
Agregue el código que enlaza los datos a una propiedad de control específica.Para obtener más información, vea Enlace de datos a una propiedad del control personalizado posterior en este documento.

Para utilizar un control personalizado para reemplazar un control existente

En el Árbol de contenido de pantalla, en la lista desplegable al lado del control que desea reemplazar, seleccione Control personalizado.
En la ventana Propiedades, junto al campo Control personalizado, haga clic en Cambiar.
En el cuadro de diálogo Agregar control personalizado, expanda el nodo de ensamblado, expanda el nodo del espacio de nombres y haga clic en Aceptar.

Si el ensamblado que contiene el control no aparece en el cuadro de diálogo Agregar control personalizado, haga clic en Agregar referencia.En el cuadro de diálogo Agregar referencia, selecciones un ensamblado o proyecto local que contenga el control que desea usar y haga clic en Aceptar.
Agregue el código que enlaza los datos a una propiedad de control específica.Para obtener más información, vea Enlace de datos a una propiedad del control personalizado posterior en este documento.

Enlazar datos a una propiedad del control personalizado

Puede enlazar los datos que especificó en el cuadro de diálogo Agregar control personalizado a una propiedad concreta del control personalizado.

Para enlazar datos a una propiedad del control personalizado

En el Diseñador de pantallas, haga clic en la flecha junto al lado del botón Escribir código y a continuación, haga clic en un método.

[!NOTA]

Elija un método que se ejecute antes de que los datos aparezcan en el control en tiempo de ejecución, por ejemplo, CustomerListDetail_Activated.

Un bloque de método parece en el Editor de código.
En el bloque de métodos, agregue código que enlace los datos de la pantalla a una propiedad del control personalizado.

El siguiente ejemplo hace referencia a un control de cuadro de lista personalizado denominado Customers.Este código enlaza una recolección de datos que se especificó en el cuadro de diálogo Agregar control personalizado a una propiedad concreta del cuadro de lista.Este código también especifica que los datos se pueden modificar utilizando este control.
```
Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub
```
```
partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}
```