DataRepeater.ItemTemplate (Propiedad)
Actualización: noviembre 2007
Obtiene una plantilla que representa DataRepeaterItem para un control DataRepeater.
Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)
Sintaxis
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem
Dim instance As DataRepeater
Dim value As DataRepeaterItem
value = instance.ItemTemplate
[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }
[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
DataRepeaterItem^ get ();
}
public function get ItemTemplate () : DataRepeaterItem
Valor de propiedad
Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Objeto que determina el diseño y la apariencia de los elementos en el control DataRepeater.
Comentarios
Utilice la propiedad ItemTemplate para establecer propiedades que determinan la apariencia en tiempo de ejecución de todos los elementos en un control DataRepeater. En efecto, está estableciendo de hecho propiedades de los objetos DataRepeaterItem que se crearán en tiempo de ejecución. Los elementos que ve en DataRepeater en tiempo de ejecución se copian de este objeto al ir desplazándose en la vista.
En tiempo de diseño, al seleccionar la sección de DataRepeater que contiene los controles, la ventana Propiedades las propiedades para ItemTemplate. Por ejemplo, establecer la propiedad BackColor de ItemTemplate en Red hace que todos los elementos de DataRepeater se muestren con un fondo rojo.
En tiempo de ejecución, si cambia las propiedades de ItemTemplate, debe llamar al método BeginResetItemTemplate antes de establecer las propiedades y, a continuación, llamar al método EndResetItemTemplate para confirmar los cambios.
La propiedad ItemTemplate también se utiliza para tener acceso a los controles en DataRepeaterItem en tiempo de ejecución. Por ejemplo, para recuperar BackColor de un TextBox denominado IDTextBox, debe utilizar el código siguiente:
Dim BC As Color = _
DataRepeater1.ItemTemplate.Controls(IDTextBox.Name).BackColor
color BC = dataRepeater1.ItemTemplate.Controls["IDTextBox"].BackColor;
Ejemplos
Entre las personalizaciones más comunes del control DataRepeater están la de mostrar las filas en colores alternos y la de cambiar el color de un campo en función de una condición. En el ejemplo siguiente se muestra cómo llevar a cabo estas personalizaciones. En este ejemplo, se supone que tiene un control DataRepeater enlazado a la tabla Products de la base de datos Northwind.
Private Sub DataRepeater1_DrawItem(ByVal sender As Object, ByVal e _
As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs) _
Handles DataRepeater1.DrawItem
' Alternate the back color.
If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
' Apply the secondary back color.
e.DataRepeaterItem.BackColor = Color.AliceBlue
Else
' Apply the default back color.
DataRepeater1.ItemTemplate.BackColor = Color.White
End If
' Change the color of out-of-stock items to red.
If e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name).Text _
< 1 Then
e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). _
BackColor = Color.Red
Else
e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). _
BackColor = Color.White
End If
End Sub
private void dataRepeater1_DrawItem(object sender,
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
// Alternate the back color.
if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
// Apply the secondary back color.
{
e.DataRepeaterItem.BackColor = Color.AliceBlue;
}
else
{
// Apply the default back color.
dataRepeater1.ItemTemplate.BackColor = Color.White;
}
// Change the color of out-of-stock items to red.
if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
{
e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
}
else
{
e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
}
}
Permisos
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.
Vea también
Referencia
Microsoft.VisualBasic.PowerPacks (Espacio de nombres)
Otros recursos
Introducción al control DataRepeater (Visual Studio)
Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio)