DataRepeater.ItemTemplate (Propiedad)

Obtiene una plantilla que representa DataRepeaterItem para un control de DataRepeater .

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

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }

[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
    DataRepeaterItem^ get ();
}

[<BrowsableAttribute(false)>]
member ItemTemplate : DataRepeaterItem

function get ItemTemplate () : DataRepeaterItem

Valor de propiedad

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Un objeto que determina el diseño y el aspecto de los elementos del control de DataRepeater .

Comentarios

Utilice la propiedad de ItemTemplate para establecer las propiedades que determinan la apariencia en tiempo de ejecución de todos los elementos en un control de DataRepeater .En efecto, establece realmente las propiedades de los objetos de DataRepeaterItem que se crearán en tiempo de ejecución.Los elementos que aparecen en DataRepeater en tiempo de ejecución se copian de este objeto mientras se desplazan en la vista.

En tiempo de diseño, cuando selecciona la sección de DataRepeater que contiene controles, la ventana Propiedades contiene las propiedades para ItemTemplate.Por ejemplo, establecer la propiedad de BackColor de ItemTemplate a Red hace que todos los elementos de DataRepeater se muestre con un fondo rojo.

En tiempo de ejecución, si cambia las propiedades de ItemTemplate, debe llamar al método de BeginResetItemTemplate antes de establecer las propiedades, y después llamar al método de EndResetItemTemplate para confirmar los cambios.

La propiedad de ItemTemplate también se utiliza para tener acceso a los controles en DataRepeaterItem en tiempo de ejecución.Por ejemplo, para recuperar BackColor de TextBox denominado IDTextBox, utilice 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.
        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.