DataRepeaterItemEventArgs.DataRepeaterItem (Propiedad)

Artículo
05/17/2015

Obtiene un objeto DataRepeaterItem que proporciona los datos para el evento DrawItem de un control DataRepeater.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
Public ReadOnly Property DataRepeaterItem As DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

public:
property DataRepeaterItem^ DataRepeaterItem {
    DataRepeaterItem^ get ();
}

member DataRepeaterItem : DataRepeaterItem with get

function get DataRepeaterItem () : DataRepeaterItem

Valor de propiedad

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Un elemento que contiene los datos, que se basa en la propiedad ItemTemplate del control DataRepeater .

Comentarios

Utilice el evento de DrawItem para cambiar la apariencia de los objetos de DataRepeaterItem como se desplazan en la vista.

En tiempo de ejecución, las propiedades relacionadas con la apariencia se pueden establecer basándose en condiciones. Por ejemplo, en una aplicación de programación, se puede cambiar el color de fondo de un elemento para advertir a los usuarios del vencimiento de un elemento. Si establece una propiedad en una instrucción condicional como If…Then, también debe utilizar una cláusula de Else para especificar el aspecto cuando la condición no se cumple.

Ejemplos

El ejemplo siguiente muestra cómo usar el controlador de eventos de DrawItem para realizar cambios cuando un elemento se desplaza en 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.
        e.DataRepeaterItem.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.
        e.DataRepeaterItem.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;
    }
}

Seguridad de .NET Framework

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.