DataRepeater.ItemTemplate (Propiedad)

Artículo
05/17/2015

Obtiene una plantilla que representa el objeto DataRepeaterItem para un control 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 with get

function get ItemTemplate () : DataRepeaterItem

Valor de propiedad

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

Comentarios

Utilice la ItemTemplate propiedad para establecer las propiedades que determinan el aspecto de tiempo de ejecución de todos los elementos de un DataRepeater control. De hecho, en realidad se establecen propiedades de la DataRepeaterItem objetos que se creará en tiempo de ejecución. Los elementos que aparecen en la DataRepeater en tiempo de ejecución se copian de este objeto como se desplazan en la vista.

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

En tiempo de ejecución, si cambia las propiedades de la ItemTemplate, debe llamar a la BeginResetItemTemplate método antes de establecer las propiedades y a continuación, llame el EndResetItemTemplate método para confirmar los cambios.

El ItemTemplate propiedad también se utiliza para tener acceso a los controles en el DataRepeaterItem en tiempo de ejecución. Por ejemplo, para recuperar la BackColor de un TextBox denominado IDTextBox, usaría el código siguiente:

Dim BC As Color = _
 DataRepeater1.ItemTemplate.Controls(IDTextBox.Name).BackColor

color BC = dataRepeater1.ItemTemplate.Controls["IDTextBox"].BackColor;

Ejemplos

Algunas personalizaciones comunes para la DataRepeater control incluyen mostrar las filas en colores alternos y cambiar el color de un campo según una condición. En el ejemplo siguiente se muestra cómo realizar estas personalizaciones. En este ejemplo se supone que tiene un DataRepeater control que está 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.