Propriedade DataRepeater.ItemTemplate

Artigo
08/25/2010

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

<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

Dim instance As DataRepeater
Dim value As DataRepeaterItem

value = instance.ItemTemplate

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

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

public function get ItemTemplate () : DataRepeaterItem

Valor de propriedade

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

Comentários

Use o ItemTemplate propriedade para conjunto propriedades que determinam a aparência de time de execução de todos os itens em um DataRepeater controle. Na verdade, você está realmente configuração propriedades do DataRepeaterItem objetos que serão criados em time de execução. sistema autônomo itens que você vê no DataRepeater em time de execução são copiados provenientes deste objeto sistema autônomo eles são colocados na exibição.

Em time de design, quando você seleciona a seção o DataRepeater que contém os controles, a janela Propriedades contém propriedades para o ItemTemplate. Por exemplo, configuração o BackColor propriedade das ItemTemplate para Red faz com que todos os itens a DataRepeater a ser exibida com um plano de fundo vermelho.

Em time de execução, se você alterar as propriedades do ItemTemplate, você deve chamar o BeginResetItemTemplate método antes de definir as propriedades e, em seguida, telefonar a EndResetItemTemplate método para confirmar as alterações.

The ItemTemplate propriedade também é usada para acessar os controles a DataRepeaterItem em time de execução. Por exemplo, para recuperar o BackColor de um TextBox chamada 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 pressupõe que você tenha um DataRepeater controle que esteja limite à tabela Produtos no banco de dados Northwind.

PrivateSub DataRepeater1_DrawItem(ByVal sender AsObject, 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.
        DataRepeater1.ItemTemplate.BackColor = Color.White
    EndIf    ' 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
    EndIfEndSub

privatevoid 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.
        dataRepeater1.ItemTemplate.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;
    }
}

Permissões

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ódigos parcialmente Confiável.