DataRepeaterItem (Clase)
Actualización: noviembre 2007
Utilizado por el control DataRepeater para mostrar los datos en tiempo de ejecución.
Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)
Sintaxis
<DockingAttribute(DockingBehavior.Never)> _
Public Class DataRepeaterItem _
Inherits Panel
Dim instance As DataRepeaterItem
[DockingAttribute(DockingBehavior.Never)]
public class DataRepeaterItem : Panel
[DockingAttribute(DockingBehavior::Never)]
public ref class DataRepeaterItem : public Panel
public class DataRepeaterItem extends Panel
Comentarios
El control DataRepeater utiliza objetos DataRepeaterItem para mostrar cada elemento del control, al ir desplazándose en la vista. En cuanto un elemento se desplaza fuera de la vista, DataRepeaterItem se invalida y se reemplaza por un nuevo DataRepeaterItem para el siguiente elemento visible.
El diseño y la apariencia de cada elemento están basados en la propiedad ItemTemplate. Cuando se representa cada DataRepeaterItem, puede modificar su apariencia en el evento DrawItem.
Nota: |
---|
Debe modificar únicamente el DataRepeaterItem al que se puede tener acceso desde el evento DrawItem. Si intenta modificarlo fuera del evento o crear un nuevo DataRepeaterItem, puede generar resultados inesperados. |
Ejemplos
En el siguiente ejemplo se muestra cómo utilizar el controlador de eventos DrawItem para realizar cambios cuando se desplaza un elemento de modo que quede a la vista. 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;
}
}
Jerarquía de herencia
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.Panel
Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
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)