Propriedade DataRepeater.ItemTemplate

Artigo
10/26/2012

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

function get ItemTemplate () : DataRepeaterItem

Valor de propriedade

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Um objeto que determina o layout e 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 um DataRepeater controle.Na verdade, você está definindo propriedades de, na verdade, o DataRepeaterItem objetos que serão criados em tempo de execução.Os itens que você consulte o DataRepeater em tempo de execução são copiados provenientes deste objeto como eles são colocados na exibição.

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

AT Runtime, se você alterar as propriedades da ItemTemplate, você deve chamar o BeginResetItemTemplate método antes de definir as propriedades e, em seguida, chamada a 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 exibir as linhas em 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 presume que você tenha um DataRepeater controle está acoplado à 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áveis.