Propriedade DataRepeater.ItemTemplate

Artigo
05/17/2015

Obtém um modelo que representa o DataRepeaterItem para um DataRepeater controle.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
<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 propriedade

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Um objeto que determina o layout e a aparência dos itens na DataRepeater controle.

Comentários

Use o ItemTemplate propriedade para definir propriedades que determinam a aparência de tempo de execução de todos os itens em uma DataRepeater controle. Na verdade, você está definindo propriedades de realmente o DataRepeaterItem objetos que serão criados no tempo de execução. Os itens que você consulte o DataRepeater em tempo de execução são copiados deste objeto conforme eles são colocados na exibição.

Em tempo de design, quando você seleciona a seção de DataRepeater que contém os controles, a janela de propriedades contém propriedades para o ItemTemplate. Por exemplo, definir a BackColor propriedade do ItemTemplate para Red faz com que todos os itens na DataRepeater seja exibida com um plano de fundo vermelho.

No tempo de execução, se você alterar as propriedades da ItemTemplate, você deve chamar o BeginResetItemTemplate método antes de definir as propriedades e, em seguida, chame o EndResetItemTemplate método para confirmar as alterações.

O ItemTemplate propriedade também é usada para acessar os controles de DataRepeaterItem em tempo de execução. Por exemplo, para recuperar o BackColor de um TextBox chamado IDTextBox, você usaria o seguinte código:

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

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

Exemplos

Algumas personalizações comuns para o DataRepeater controle incluem a exibição de linhas de cores alternadas e alterando a cor de um campo com base em uma condição. O exemplo a seguir mostra como realizar essas personalizações. Este exemplo pressupõe que você tenha um DataRepeater controle ligado à tabela Produtos no banco de dados 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;
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.