ListView.Items Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma coleção de ListViewDataItem objetos que representam os itens de dados da página atual de dados num ListView controlo.
public:
virtual property System::Collections::Generic::IList<System::Web::UI::WebControls::ListViewDataItem ^> ^ Items { System::Collections::Generic::IList<System::Web::UI::WebControls::ListViewDataItem ^> ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Collections.Generic.IList<System.Web.UI.WebControls.ListViewDataItem> Items { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Items : System.Collections.Generic.IList<System.Web.UI.WebControls.ListViewDataItem>
Public Overridable ReadOnly Property Items As IList(Of ListViewDataItem)
Valor de Propriedade
Um objeto que contém todos os itens de dados da página atual de dados num ListView controlo.
- Atributos
Exemplos
O exemplo seguinte mostra como usar a Items coleção para aceder ao item que está a ser editado num ListView controlo. Este exemplo de código faz parte de um exemplo maior fornecido para o ItemEditing evento.
void ProductsListView_ItemEditing(Object sender, ListViewEditEventArgs e)
{
ListViewItem item = ProductsListView.Items[e.NewEditIndex];
Label dateLabel = (Label)item.FindControl("DiscontinuedDateLabel");
if (String.IsNullOrEmpty(dateLabel.Text))
return;
//Verify if the item is discontinued.
DateTime discontinuedDate = DateTime.Parse(dateLabel.Text);
if (discontinuedDate < DateTime.Now)
{
Message.Text = "You cannot edit a discontinued item.";
e.Cancel = true;
ProductsListView.SelectedIndex = -1;
}
}
Sub ProductsListView_ItemEditing(ByVal sender As Object, ByVal e As ListViewEditEventArgs)
Dim item As ListViewItem = ProductsListView.Items(e.NewEditIndex)
Dim dateLabel As Label = CType(item.FindControl("DiscontinuedDateLabel"), Label)
If String.IsNullOrEmpty(dateLabel.Text) Then _
Return
'Verify if the item is discontinued.
Dim discontinuedDate As DateTime = DateTime.Parse(dateLabel.Text)
If discontinuedDate < DateTime.Now Then
Message.Text = "You cannot edit a discontinued item."
e.Cancel = True
ProductsListView.SelectedIndex = -1
End If
End Sub
Observações
A Items propriedade é usada para armazenar os itens de dados num ListView controlo. O ListView controlo preenche automaticamente a Items coleção criando um ListViewDataItem objeto para cada registo na página atual de dados na fonte de dados. Depois, adiciona cada objeto à coleção. Esta propriedade é geralmente usada para aceder a um item específico no controlo ou para iterar pela coleção completa de itens.