ListView Classe
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.
Apresenta os valores de uma fonte de dados utilizando modelos definidos pelo utilizador. O ListView controlo permite aos utilizadores selecionar, ordenar, eliminar, editar e inserir registos.
public ref class ListView : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IPageableItemContainer, System::Web::UI::WebControls::IPersistedSelector
public ref class ListView : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::IDataKeysControl, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IPageableItemContainer, System::Web::UI::WebControls::IPersistedSelector
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.ico")]
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IPageableItemContainer, System.Web.UI.WebControls.IPersistedSelector
[System.Web.UI.ControlValueProperty("SelectedValue")]
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.bmp")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.IDataKeysControl, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IPageableItemContainer, System.Web.UI.WebControls.IPersistedSelector
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.ico")>]
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type ListView = class
inherit DataBoundControl
interface INamingContainer
interface IPageableItemContainer
interface IPersistedSelector
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.bmp")>]
type ListView = class
inherit DataBoundControl
interface INamingContainer
interface IPageableItemContainer
interface IPersistedSelector
interface IDataKeysControl
interface IDataBoundListControl
interface IDataBoundControl
Public Class ListView
Inherits DataBoundControl
Implements INamingContainer, IPageableItemContainer, IPersistedSelector
Public Class ListView
Inherits DataBoundControl
Implements IDataBoundListControl, IDataKeysControl, INamingContainer, IPageableItemContainer, IPersistedSelector
- Herança
- Atributos
- Implementações
Exemplos
O exemplo seguinte mostra como usar o ListView controlo para exibir registos de uma base de dados utilizando uma tabela HTML. Os valores são recuperados usando um LinqDataSource controlo.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
DataKeyNames="VendorID"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
<tr runat="server" style="background-color: #98FB98">
<th runat="server">ID</th>
<th runat="server">Account Number</th>
<th runat="server">Name</th>
<th runat="server">Preferred Vendor</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager ID="DataPager1" runat="server">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
<td>
<asp:CheckBox ID="PreferredCheckBox" runat="server"
Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Add a LINQ -->
<!-- to SQL class to the project to map to a table in -->
<!-- the database. -->
<asp:LinqDataSource ID="VendorsDataSource" runat="server"
ContextTypeName="AdventureWorksClassesDataContext"
Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)"
TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
<WhereParameters>
<asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
</WhereParameters>
</asp:LinqDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
DataKeyNames="VendorID"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
<tr runat="server" style="background-color: #98FB98">
<th runat="server">ID</th>
<th runat="server">Account Number</th>
<th runat="server">Name</th>
<th runat="server">Preferred Vendor</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager ID="DataPager1" runat="server">
<Fields>
<asp:NumericPagerField />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
<td>
<asp:CheckBox ID="PreferredCheckBox" runat="server"
Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Add a LINQ -->
<!-- to SQL class to the project to map to a table in -->
<!-- the database. -->
<asp:LinqDataSource ID="VendorsDataSource" runat="server"
ContextTypeName="AdventureWorksClassesDataContext"
Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)"
TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
<WhereParameters>
<asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
</WhereParameters>
</asp:LinqDataSource>
</form>
</body>
</html>
O exemplo seguinte mostra como usar o ListView controlo para mostrar valores num layout de fluxo usando o div elemento. Os valores são recuperados usando um SqlDataSource controlo.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Flow Layout Example</title>
<style type="text/css">
.plainBox {
font-family: Verdana, Arial, sans-serif;
font-size: 11px;
background: #ffffff;
border:1px solid #336666;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Flow Layout Example</h3>
Select the color:
<asp:DropDownList ID="ColorList" runat="server"
AutoPostBack="True"
DataSourceID="ColorDataSource"
DataTextField="Color"
DataValueField="Color">
</asp:DropDownList><br /><br />
<asp:ListView runat="server" ID="ProductListView"
DataSourceID="ProductsDataSource"
DataKeyNames="ProductID">
<LayoutTemplate>
<div runat="server" id="lstProducts">
<div runat="server" id="itemPlaceholder" />
</div>
<asp:DataPager runat="server" PageSize="5" >
<Fields>
<asp:NextPreviousPagerField
ButtonType="Button"
ShowFirstPageButton="True"
ShowLastPageButton="True" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<asp:Image ID="ProductImage" runat="server"
ImageUrl='<%# "~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' />
<div class="plainBox" runat="server">
<asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>'
NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' />
<br /><br />
<b>Price:</b>
<asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
</div>
<br />
</ItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="ProductsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice,
PF.ThumbnailPhotoFileName, P.Size
FROM Production.Product AS P
INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID
INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
WHERE P.Color = @Color" >
<SelectParameters>
<asp:ControlParameter ControlID="ColorList" Name="Color"
PropertyName="SelectedValue" />
</SelectParameters>
</asp:SqlDataSource>
<asp:SqlDataSource ID="ColorDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT DISTINCT Color FROM Production.Product">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Flow Layout Example</title>
<style type="text/css">
.plainBox {
font-family: Verdana, Arial, sans-serif;
font-size: 11px;
background: #ffffff;
border:1px solid #336666;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Flow Layout Example</h3>
Select the color:
<asp:DropDownList ID="ColorList" runat="server"
AutoPostBack="True"
DataSourceID="ColorDataSource"
DataTextField="Color"
DataValueField="Color">
</asp:DropDownList><br /><br />
<asp:ListView runat="server" ID="ProductListView"
DataSourceID="ProductsDataSource"
DataKeyNames="ProductID">
<LayoutTemplate>
<div runat="server" id="lstProducts">
<div runat="server" id="itemPlaceholder" />
</div>
<asp:DataPager ID="DataPager1" runat="server" PageSize="5" >
<Fields>
<asp:NextPreviousPagerField
ButtonType="Button"
ShowFirstPageButton="True"
ShowLastPageButton="True" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<asp:Image ID="ProductImage" runat="server"
ImageUrl='<%# "~/images/thumbnails/" & Eval("ThumbnailPhotoFileName") %>' />
<div class="plainBox" runat="server">
<asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>'
NavigateUrl='<%# "ProductDetails.aspx?productID=" & Eval("ProductID") %>' />
<br /><br />
<b>Price:</b>
<asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
</div>
<br />
</ItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="ProductsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice,
PF.ThumbnailPhotoFileName, P.Size
FROM Production.Product AS P
INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID
INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
WHERE P.Color = @Color" >
<SelectParameters>
<asp:ControlParameter ControlID="ColorList" Name="Color"
PropertyName="SelectedValue" />
</SelectParameters>
</asp:SqlDataSource>
<asp:SqlDataSource ID="ColorDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT DISTINCT Color FROM Production.Product">
</asp:SqlDataSource>
</form>
</body>
</html>
O exemplo seguinte mostra como usar o ListView controlo para inserir, eliminar e atualizar registos.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Example</title>
<style type="text/css">
.EditItem { background-color:#8FBC8F;}
.SelectedItem { background-color:#9ACD32; }
.InsertItem { background-color:#FFFACD;}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Example</h3>
<h5>Departments</h5>
<asp:ListView ID="DepartmentsListView"
DataSourceID="DepartmentsDataSource"
DataKeyNames="DepartmentID"
ConvertEmptyStringToNull="true"
InsertItemPosition="LastItem"
runat="server">
<LayoutTemplate>
<table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
<asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
</td>
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
</td>
</tr>
</ItemTemplate>
<SelectedItemTemplate>
<tr class="SelectedItem" runat="server">
<td>
<asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
<asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
</td>
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
</td>
</tr>
</SelectedItemTemplate>
<EditItemTemplate>
<tr class="EditItem">
<td>
<asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
<asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
</td>
<td>
<b>ID</b><br />
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox"
Text="Name" Font-Bold="true"/><br />
<asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
</td>
<td>
<asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox"
Text="Group Name" Font-Bold="true" /><br />
<asp:TextBox ID="GroupNameTextBox" runat="server"
Width="200px"
Text='<%#Bind("GroupName") %>' />
<br />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr class="InsertItem">
<td colspan="2">
<asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
<asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
</td>
<td>
<asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox"
Text="Name" Font-Bold="true"/><br />
<asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
</td>
<td>
<asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox"
Text="Group Name" Font-Bold="true" /><br />
<asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="DepartmentsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
UpdateCommand="UPDATE HumanResources.Department
SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"
DeleteCommand="DELETE FROM HumanResources.Department
WHERE (DepartmentID = @DepartmentID)"
InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName)
VALUES (@Name, @GroupName)">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView Example</title>
<style type="text/css">
.EditItem { background-color:#8FBC8F;}
.SelectedItem { background-color:#9ACD32; }
.InsertItem { background-color:#FFFACD;}
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView Example</h3>
<h5>Departments</h5>
<asp:ListView ID="DepartmentsListView"
DataSourceID="DepartmentsDataSource"
DataKeyNames="DepartmentID"
ConvertEmptyStringToNull="true"
InsertItemPosition="LastItem"
runat="server">
<LayoutTemplate>
<table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
<tr runat="server" id="itemPlaceholder" />
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
<asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
</td>
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
</td>
</tr>
</ItemTemplate>
<SelectedItemTemplate>
<tr class="SelectedItem" runat="server">
<td>
<asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
<asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
</td>
<td>
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td>
<asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
</td>
</tr>
</SelectedItemTemplate>
<EditItemTemplate>
<tr class="EditItem">
<td>
<asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
<asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
</td>
<td>
<b>ID</b><br />
<asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
</td>
<td>
<asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox"
Text="Name" Font-Bold="true"/><br />
<asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
</td>
<td>
<asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox"
Text="Group Name" Font-Bold="true" /><br />
<asp:TextBox ID="GroupNameTextBox" runat="server"
Width="200px"
Text='<%#Bind("GroupName") %>' />
<br />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr class="InsertItem">
<td colspan="2">
<asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
<asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
</td>
<td>
<asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox"
Text="Name" Font-Bold="true"/><br />
<asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
</td>
<td>
<asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox"
Text="Group Name" Font-Bold="true" /><br />
<asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="DepartmentsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
UpdateCommand="UPDATE HumanResources.Department
SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"
DeleteCommand="DELETE FROM HumanResources.Department
WHERE (DepartmentID = @DepartmentID)"
InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName)
VALUES (@Name, @GroupName)">
</asp:SqlDataSource>
</form>
</body>
</html>
Observações
Neste artigo:
Introdução
O ListView controlo é usado para mostrar os valores de uma fonte de dados. Assemelha-se ao GridView controlo, exceto que apresenta os dados usando modelos definidos pelo utilizador em vez de campos de linhas. Criar os seus próprios modelos dá-lhe mais flexibilidade no controlo de como os dados são apresentados.
O ListView controlo suporta as seguintes funcionalidades:
- Suporte para ligação a controlos de fonte de dados como SqlDataSource, LinqDataSource, e ObjectDataSource.
- Aparência personalizável através de modelos e estilos definidos pelo utilizador.
- Capacidades integradas de ordenação.
- Funcionalidades integradas de atualização e eliminação.
- Capacidades de inserção integradas.
- Suporte para capacidades de paginação através de um DataPager controlo.
- Capacidades integradas de seleção de itens.
- Acesso programático ao ListView modelo de objetos para definir dinamicamente propriedades, gerir eventos, e assim por diante.
- Múltiplos campos de chave.
Para saber mais sobre outros controlos ligados a dados disponíveis em ASP.NET, consulte Data-Bound Controlos do Servidor Web.
Templates
Para que o ListView controlo mostre conteúdo, deve criar modelos para diferentes partes do controlo. O ItemTemplate é obrigatório. Todos os outros modelos são opcionais. A LayoutTemplate propriedade não é obrigatória.
No entanto, deve criar um modelo para o modo em que o controlo está configurado. Por exemplo, um ListView controlo que suporta a inserção de registos deve ter um InsertItemTemplate template definido. A tabela seguinte lista os modelos que pode criar para o ListView controlo.
| Tipo de modelo | Descrição |
|---|---|
| LayoutTemplate | O template raiz que define um objeto contentor, como um table, div, ou span elemento, que conterá o conteúdo definido no ItemTemplate ou GroupTemplate template. Também pode conter um DataPager objeto. |
| ItemTemplate | Define o conteúdo vinculado aos dados a mostrar para itens individuais. |
| ItemSeparatorTemplate | Define o conteúdo a renderizar entre itens individuais. |
| GroupTemplate | Define um objeto contentor, como uma linha de tabela (tr), , ou div elemento, que conterá o conteúdo definido nos span templates e.ItemTemplateEmptyItemTemplate O número de itens que são exibidos num grupo é especificado pela GroupItemCount propriedade. |
| GroupSeparatorTemplate | Define o conteúdo a renderizar entre grupos de itens. |
| EmptyItemTemplate | Define o conteúdo a renderizar para um item vazio quando um GroupTemplate modelo é utilizado. Por exemplo, se a GroupItemCount propriedade estiver definida para 5, e o número total de itens devolvidos da fonte de dados for 8, o último grupo de dados apresentado pelo ListView controlo conterá três itens conforme especificado pelo ItemTemplate modelo e dois itens conforme especificado pelo EmptyItemTemplate modelo. |
| EmptyDataTemplate | Define o conteúdo a renderizar se a fonte de dados não devolver dados. |
| SelectedItemTemplate | Define o conteúdo a renderizar para o elemento de dados selecionado para diferenciar o item selecionado dos outros itens. |
| AlternatingItemTemplate | Define o conteúdo a renderizar para itens alternados, de modo a facilitar a distinção entre itens consecutivos. |
| EditItemTemplate | Define o conteúdo a renderizar quando um item está a ser editado. O EditItemTemplate modelo é renderizado em vez do ItemTemplate modelo do elemento de dados que está a ser editado. |
| InsertItemTemplate | Define o conteúdo a renderizar para inserir um item. O InsertItemTemplate modelo é renderizado em vez de um ItemTemplate modelo no início ou no final dos itens que são apresentados pelo ListView controlo. Pode especificar onde o InsertItemTemplate template é renderizado usando a InsertItemPosition propriedade do ListView controlo. |
Para mostrar o valor de um campo num modelo como ItemTemplate, utiliza-se uma expressão de ligação de dados. Para mais informações sobre expressões de ligação de dados, consulte Data-Binding Visão Geral das Expressões.
Para associar controlos de entrada nos EditItemTemplate templates and InsertItemTemplate aos campos de uma fonte de dados, pode usar expressões de ligação bidirecional. Isto permite que o ListView controlo extraia automaticamente os valores do controlo de entrada para uma operação de atualização ou inserção. Expressões de ligação bidirecional também permitem controlos de entrada em e EditItemTemplate para mostrar automaticamente os valores originais dos campos. Para mais informações sobre expressões de ligação bidirecional, veja Binding to Databases.
Ligação a uma Fonte de Dados
Pode associar o ListView controlo a um controlo de fonte de dados (como o SqlDataSource controlo ou ObjectDataSource controlo) ou a qualquer coleção de fontes de dados que implemente a System.Collections.IEnumerable interface, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, ou outros tipos de coleções. Use um dos seguintes métodos para associar o ListView controlo ao tipo de fonte de dados apropriado:
Para ligar a um controlo de fonte de dados, defina a DataSourceID propriedade do ListView controlo para o ID valor do controlo de fonte de dados. O ListView controlo liga-se automaticamente ao controlo de fonte de dados especificado e pode tirar partido das capacidades do controlo de fonte de dados para realizar funcionalidades de ordenação, inserção, atualização, eliminação e paginação. Este é o método preferido para vincular dados.
Para ligar a uma fonte de dados que implemente a System.Collections.IEnumerable interface, defina programaticamente a DataSource propriedade do ListView controlo para a fonte de dados e depois chame o DataBind método. Quando utiliza esta técnica, o controlo ListView não fornece funcionalidade incorporada de ordenação, atualização, eliminação e paginação. Deve fornecer esta funcionalidade utilizando o evento apropriado.
Para mais informações sobre ligação de dados, consulte ASP.NET Data Access Content Map.
Note
O ListView controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para script executável, instruções SQL ou outro código antes de a apresentar na aplicação. Recomendamos fortemente que os valores sejam codificados em HTML sempre que possível antes de serem exibidos neste controlo. O ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para ajudar a blocar scripts e HTML na entrada do utilizador. Também pode usar os controlos do servidor de validação para verificar a entrada do utilizador. Para mais informações, consulte Introdução aos Controlos de Validação.
Operações de Dados
Quando o ListView controlo está ligado a um controlo de fonte de dados, este ListView pode tirar partido das capacidades do controlo de fonte de dados e fornecer funcionalidades automáticas de ordenação, inserção, atualização e eliminação.
Note
O ListView controlo pode fornecer suporte para ordenar, inserir, atualizar e eliminar com outros tipos de fontes de dados. No entanto, para implementar estas operações, é necessário criar código num gestor de eventos apropriado.
Como o ListView controlo utiliza templates, não oferece uma forma de gerar automaticamente botões para realizar operações, atualizar, eliminar, inserir, ordenar ou selecionar. Deve incluir manualmente estes botões no modelo apropriado. O ListView controlo reconhece certos botões cuja CommandName propriedade está definida para um valor específico. A tabela seguinte lista os botões que o ListView controlo reconhece e as suas funções.
| Botão | Valor CommandName | Descrição |
|---|---|---|
| Cancelar | Cancelar | Cancela uma operação de edição ou inserção. Eleva o ItemCanceling evento. |
| Eliminar | "Apagar" | Apaga o registo atual da fonte de dados. Aumenta os ItemDeleted eventos e ItemDeleting eventos. |
| Selecionar | "Selecionar" | Define a SelectedIndex propriedade para o DisplayIndex valor do imóvel correspondente ao item. Renderiza o SelectedItemTemplate modelo do item. Aumenta os SelectedIndexChanging eventos e SelectedIndexChanged eventos. |
| Editar | "Editar" | Coloca o item em modo de edição. Renderiza o EditItemTemplate modelo do item. Eleva o ItemEditing evento. |
| Inserir | "Inserir" | Insere os valores vinculados do InsertItemTemplate template na fonte de dados. Aumenta os ItemInserting eventos e ItemInserted eventos. |
| Atualização | "Atualização" | Atualiza o registo atual na fonte de dados com os valores vinculados do EditItemTemplate modelo. Aumenta os ItemUpdating eventos e ItemUpdated eventos. |
| Sort | "Sort" | Ordena as colunas listadas na CommandArgument propriedade do botão. Aumenta os Sorting eventos e Sorted eventos. |
Ao contrário do botão Delete (que elimina imediatamente o elemento de dados atual), quando o botão Editar é clicado, o ListView controlo mostra o item atual em modo de edição. No modo de edição, o conteúdo contido na EditItemTemplate propriedade é apresentado para o elemento de dados atual. Normalmente, no modelo de editar item, o botão Editar é substituído por um botão Atualizar e um botão Cancelar. Controlos de entrada apropriados para o tipo de dado do campo (como a TextBox ou CheckBox controlo) também costumam mostrar o valor de um campo para o utilizador modificar. Clicar no botão Atualizar atualiza o registo na fonte de dados, e clicar no botão Cancelar cancela a operação de edição.
A funcionalidade de inserção é ativada quando a InsertItemPosition propriedade está definida como FirstItem ou LastItem. Esta propriedade define onde o InsertItemTemplate template é renderizado para o item inserido. O modelo de inserção de item normalmente inclui um botão Inserir e um botão Cancelar, e controlos de entrada vazios são exibidos para que os utilizadores possam inserir os valores do novo registo. Clicar no botão Inserir insere o registo na fonte de dados, e clicar no botão Cancelar apaga todos os campos.
Ordenação
O ListView controlo permite aos utilizadores ordenar os itens clicando no botão Ordenar. A funcionalidade de ordenação está definida na CommandArgument propriedade do botão que contém as colunas a ordenar.
Paging
Em vez de mostrar todos os registos da fonte de dados ao mesmo tempo, o ListView controlo pode dividir os registos em páginas. Para ativar a paginação, associe um DataPager controlo ao ListView controlo. Depois insere um DataPager controlo dentro do LayoutTemplate modelo. Alternativamente, se o controlo DataPager estiver fora do ListView controlo, define a PagedControlID propriedade para o ID do ListView controlo.
Eventos
A tabela seguinte lista os eventos suportados pelo ListView controlo.
| Evento | Descrição |
|---|---|
| ItemCanceling | Ocorre quando o botão Cancelar (um botão com CommandName a propriedade definida como "Cancelar") é clicado, mas antes do ListView controlo cancelar a operação de inserção ou edição. Este evento é frequentemente usado para parar a operação de cancelamento. |
| ItemCommand | Ocorre quando um botão é clicado no ListView controlo. Este evento é frequentemente usado para realizar uma tarefa personalizada quando um botão é pressionado no controlo. |
| ItemCreated | Ocorre quando um novo item é criado no ListView controlo. Este evento é frequentemente usado para modificar o conteúdo de um item quando este é criado. |
| ItemDataBound | Ocorre quando um elemento de dados está ligado a dados no ListView controlo. Este evento é frequentemente usado para modificar o conteúdo de um item quando este está ligado a dados. |
| ItemDeleted | Ocorre quando um botão Delete (um botão com CommandName a propriedade definida para "Eliminar") é clicado ou o DeleteItem método é chamado, após o ListView controlo eliminar o registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de eliminação. |
| ItemDeleting | Ocorre quando um botão Delete (um botão com CommandName a propriedade definida para "Delete") é clicado ou o DeleteItem método é chamado, mas antes de o ListView controlo eliminar o registo da fonte de dados. Este evento é frequentemente usado para confirmar ou cancelar a operação de eliminação. |
| ItemEditing | Ocorre quando um botão de Editar (um botão com CommandName a propriedade definida para "Editar") é clicado, mas antes do ListView controlo entrar no modo de edição. Este evento é frequentemente usado para cancelar a operação de edição. |
| ItemInserted | Ocorre quando um botão Insert (um botão com CommandName a propriedade definida como "Insert") é clicado ou o InsertNewItem método é chamado, após o ListView controlo inserir o novo registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de inserção. |
| ItemInserting | Ocorre quando um botão Insert (um botão com CommandName a propriedade definida para "Insert") é clicado ou o InsertNewItem método é chamado, mas antes do controlo ListView inserir o registo. Este evento é frequentemente usado para cancelar a operação de inserção ou alterar ou validar os valores do novo item. |
| ItemUpdated | Ocorre quando um botão Atualizar (um botão com CommandName a propriedade definida para "Atualizar") é clicado ou o UpdateItem método é chamado, após o controlo ListView atualizar o registo. Este evento é frequentemente usado para verificar os resultados da operação de atualização. |
| ItemUpdating | Ocorre quando um botão Atualizar (um botão com CommandName a propriedade definida como "Atualizar") é clicado ou o UpdateItem método é chamado, mas antes de o ListView controlo atualizar o registo. Este evento é frequentemente usado para cancelar a operação de atualização ou alterar ou validar os valores do item editado. |
| LayoutCreated | Ocorre quando o LayoutTemplate template é criado num ListView controlo. Este evento é frequentemente usado para realizar uma tarefa após a criação do modelo. |
| PagePropertiesChanged | Ocorre quando as propriedades da página mudam, depois de o controlo ListView definir os novos valores. |
| PagePropertiesChanging | Ocorre quando as propriedades da página de dados mudam, mas antes do controlo ListView definir os novos valores. |
| SelectedIndexChanged | Ocorre quando um botão Select (um botão com CommandName a propriedade definida para "Select") é clicado, depois de o ListView controlo tratar da operação select. Este evento é frequentemente usado para realizar uma tarefa personalizada após um item ser selecionado no controlo. |
| SelectedIndexChanging | Ocorre quando um botão Select (um botão com CommandName a propriedade definida para "Select") é clicado, mas antes do controlo ListView tratar da operação de seleção. Este evento é frequentemente usado para cancelar a operação de seleção. |
| Sorted | Ocorre quando um botão de Ordenar (um botão com CommandName a propriedade definida para "Ordenar") é clicado ou o Sort método é chamado, depois de o ListView controlo tratar da operação de ordenação. Este evento é normalmente utilizado para realizar uma tarefa personalizada após o utilizador clicar num botão Ordenar e os dados terem sido organizados. |
| Sorting | Ocorre quando um botão de Ordenar (um botão com CommandName a propriedade definida como "Ordenar") é clicado ou o Sort método é chamado, mas antes do ListView controlo tratar da operação de ordenação. Este evento é frequentemente usado para cancelar a operação de ordenação ou para executar uma rotina de ordenação personalizada. |
Sintaxe declarativa
<asp:ListView
ConvertEmptyStringToNull="True|False"
DataKeyNames="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
EditIndex="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
GroupPlaceholderID="string"
GroupItemCount="integer"
ID="string"
InsertItemPosition="None|FirstItem|LastItem"
ItemPlaceholderID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnItemCanceling="ItemCanceling event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDataBound="ItemDataBound event handler"
OnItemDeleted="ItemDeleted event handler"
OnItemDeleting="ItemDeleting event handler"
OnItemEditing="ItemEditing event handler"
OnItemInserted="ItemInserted event handler"
OnItemInserting="ItemInserting event handler"
OnItemUpdated="ItemUpdated event handler"
OnItemUpdating="ItemUpdating event handler"
OnLayoutCreated="LayoutCreated event handler"
OnLoad="Load event handler"
OnPagePropertiesChanged="PagePropertiesChanged event handler"
OnPagePropertiesChanging="PagePropertiesChanging event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnSelectedIndexChanging="SelectedIndexChanging event handler"
OnSorted="Sorted event handler"
OnSorting="Sorting event handler"
OnUnload="Unload event handler"
runat="server"
SelectedIndex="integer"
SkinID="string"
Style="string"
Visible="True|False"
>
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<EmptyItemTemplate>
<!-- child controls -->
</EmptyItemTemplate>
<GroupSeparatorTemplate>
<!-- child controls -->
</GroupSeparatorTemplate>
<GroupTemplate>
<!-- child controls -->
</GroupTemplate>
<InsertItemTemplate>
<!-- child controls -->
</InsertItemTemplate>
<ItemSeparatorTemplate>
<!-- child controls -->
</ItemSeparatorTemplate>
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<LayoutTemplate>
<!-- child controls -->
</LayoutTemplate>
<SelectedItemTemplate>
<!-- child controls -->
</SelectedItemTemplate>
</asp:ListView>
Construtores
| Name | Description |
|---|---|
| ListView() |
Inicializa uma nova instância da ListView classe. |
Propriedades
| Name | Description |
|---|---|
| AccessKey |
Sobrepõe-se à propriedade AccessKey . Definir esta propriedade não é suportado pelo ListView controlo. |
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AlternatingItemTemplate |
Obtém ou define o conteúdo personalizado para o item de dados alternado num ListView controlo. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| Attributes |
Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl) |
| BackColor |
Sobrepõe-se à propriedade BackColor . Definir esta propriedade não é suportado pelo ListView controlo. |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| BorderColor |
Sobrepõe-se à propriedade BorderColor . Definir esta propriedade não é suportado pelo ListView controlo. |
| BorderStyle |
Sobrepõe-se à propriedade BorderStyle . Definir esta propriedade não é suportado pelo ListView controlo. |
| BorderWidth |
Sobrepõe-se à propriedade BorderWidth . Definir esta propriedade não é suportado pelo ListView controlo. |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDRowSuffix |
Obtém ou define o nome do campo de dados cujo valor é usado para identificar de forma única cada linha de dados de um ListView controlo quando a ClientIDMode propriedade é definida para Predictable. |
| ClientIDRowSuffixDataKeys |
Obtém os valores de dados que são usados para identificar de forma única cada instância de um controlo data-bound quando ASP.NET gera o valor ClientID. |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controlos filhos do ListView controlo. |
| ControlStyle |
Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| ControlStyleCreated |
Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se os valores de cadeia vazios ("") são automaticamente convertidos em valores nulos quando o campo de dados é atualizado na fonte de dados. |
| CssClass |
Sobrepõe-se à propriedade CssClass . Definir esta propriedade não é suportado pelo ListView controlo. |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataKeyNames |
Obtém ou define um array que contém os nomes dos campos de chave primária para os itens apresentados num ListView controlo. |
| DataKeys |
Obtém uma coleção de DataKey objetos que representam o valor da chave de dados para cada item num ListView controlo. |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define o nome da lista de dados à qual o controlo de dados se liga, nos casos em que a fonte de dados contém mais do que uma lista distinta de itens de dados. (Herdado de DataBoundControl) |
| DataSource |
Obtém ou define o objeto a partir do qual o controlo ligado a dados recupera a sua lista de itens de dados. (Herdado de BaseDataBoundControl) |
| DataSourceID |
Obtém ou define o ID do controlo do qual o controlo limitado por dados recupera a sua lista de itens de dados. (Herdado de DataBoundControl) |
| DataSourceObject |
Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl) |
| DeleteMethod |
Obtém ou define o nome do método a chamar para apagar dados. |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| EditIndex |
Obtém ou define o índice do item que está a ser editado. |
| EditItem |
Obtém o item que está em modo de edição num ListView controlo. |
| EditItemTemplate |
Obtém ou define o conteúdo personalizado do item em modo de edição. |
| EmptyDataTemplate |
Obtém ou define o conteúdo definido pelo utilizador para o template vazio que é renderizado quando um ListView controlo está associado a uma fonte de dados que não contém registos. |
| EmptyItemTemplate |
Recebe ou define o conteúdo definido pelo utilizador para o item vazio que é renderizado num ListView controlo quando não há mais itens de dados para mostrar na última linha da página de dados atual. |
| Enabled |
Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl) |
| EnableModelValidation |
Recebe ou define um valor que indica se um controlo do validador irá tratar exceções que ocorrem durante operações de inserção ou atualização. |
| EnablePersistedSelection |
Obtém ou define um valor que indica se a seleção de linhas persiste quando um utilizador percorre dados num controlo vinculado a dados. |
| EnableTheming |
Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| Font |
Sobrepõe-se à propriedade Font . Esta propriedade não é suportada pelo ListView controlo. |
| ForeColor |
Sobrepõe-se à propriedade ForeColor . Definir esta propriedade não é suportado pelo ListView controlo. |
| GroupItemCount |
Obtém ou define o número de itens a exibir por grupo num ListView controlo. |
| GroupPlaceholderID |
Obtém ou define o ID do grupo temporário num ListView controlo. |
| GroupSeparatorTemplate |
Obtém ou define o conteúdo definido pelo utilizador para o separador entre grupos num ListView controlo. |
| GroupTemplate |
Obtém ou define o conteúdo definido pelo utilizador para o contentor do grupo num ListView controlo. |
| HasAttributes |
Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl) |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| Height |
Sobrepõe-se à propriedade Height . Definir esta propriedade não é suportado pelo ListView controlo. |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| Initialized |
Obtém um valor que indica se o controlo ligado a dados foi inicializado. (Herdado de BaseDataBoundControl) |
| InsertItem |
Obtém o item inserido de um ListView controlo. |
| InsertItemPosition |
Obtém ou define a localização do InsertItemTemplate template quando este é renderizado como parte do ListView controlo. |
| InsertItemTemplate |
Obtém ou define o conteúdo personalizado para um item inserido no ListView controlo. |
| InsertMethod |
Obtém ou define o nome do método a chamar para inserir dados. |
| IsBoundUsingDataSourceID |
Recebe um valor que indica se a DataSourceID propriedade está definida. (Herdado de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsDataBindingAutomatic |
Obtém um valor que indica se a ligação de dados é automática. (Herdado de BaseDataBoundControl) |
| IsEnabled |
Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsUsingModelBinders |
Obtém um valor que indica se a binding do modelo está em uso. |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| ItemPlaceholderID |
Obtém ou define o ID do item marcador num ListView controlo. |
| Items |
Obtém uma coleção de ListViewDataItem objetos que representam os itens de dados da página atual de dados num ListView controlo. |
| ItemSeparatorTemplate |
Obtém ou define o conteúdo personalizado para o separador entre os itens num ListView controlo. |
| ItemTemplate |
Obtém ou define o conteúdo personalizado do elemento de dados num ListView controlo. |
| ItemType |
Obtém ou define o nome do tipo de elemento de dados para ligação de dados fortemente tipada. (Herdado de DataBoundControl) |
| LayoutTemplate |
Obtém ou define o conteúdo personalizado para o contentor raiz num ListView controlo. |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| MaximumRows |
Obtém o número máximo de itens para mostrar numa única página do ListView controlo. |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RequiresDataBinding |
Recebe ou define um valor que indica se o DataBind() método deve ser chamado. (Herdado de BaseDataBoundControl) |
| SelectArguments |
Obtém um DataSourceSelectArguments objeto que o controlo data-bound usa ao recuperar dados de um controlo de fonte de dados. (Herdado de DataBoundControl) |
| SelectedDataKey |
Obtém o valor da chave de dados para o item selecionado num ListView controlo. |
| SelectedIndex |
Obtém ou define o índice do item selecionado num ListView controlo. |
| SelectedItemTemplate |
Obtém ou define o conteúdo personalizado para o item selecionado num ListView controlo. |
| SelectedPersistedDataKey |
Obtém ou define o valor da chave de dados para o item selecionado persistido num controlo data-bound. |
| SelectedValue |
Obtém o valor da chave de dados do item selecionado num ListView controlo. |
| SelectMethod |
O nome do método a chamar para ler dados. (Herdado de DataBoundControl) |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl) |
| SortDirection |
Obtém a direção do campo ou campos que estão a ser organizados. |
| SortExpression |
Obtém a expressão de ordenação associada ao campo ou campos que estão a ser ordenados. |
| StartRowIndex |
Obtém o índice do primeiro registo que é exibido numa página de dados no ListView controlo. |
| Style |
Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controlo deve definir o |
| TabIndex |
Sobrepõe-se à propriedade TabIndex . Definir esta propriedade não é suportado pelo ListView controlo. |
| TagKey |
Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TagName |
Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| ToolTip |
Sobrepõe-se à propriedade ToolTip . Definir esta propriedade não é suportado pelo ListView controlo. |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| UpdateMethod |
Obtém ou define o nome do método a chamar para atualizar os dados. |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| Visible |
Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control) |
| Width |
Sobrepõe-se à propriedade Width . Definir esta propriedade não é suportado pelo ListView controlo. |
Métodos
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| AddControlToContainer(Control, Control, Int32) |
Adiciona o controlo especificado ao contentor especificado. |
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control) |
| ApplyStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| ConfirmInitState() |
Define o estado inicializado do controlo ligado a dados. (Herdado de BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| CreateChildControls() |
Cria a hierarquia de controlo que é usada para renderizar o ListView controlo, com base nos valores armazenados no estado da vista. |
| CreateChildControls(IEnumerable, Boolean) |
Cria a hierarquia de controlo que é usada para renderizar o ListView controlo usando a fonte de dados especificada. |
| CreateControlCollection() |
Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control) |
| CreateControlStyle() |
Cria o estilo padrão do controlo. |
| CreateDataItem(Int32, Int32) |
Cria um elemento de dados no ListView controlo. |
| CreateDataSourceSelectArguments() |
Cria o DataSourceSelectArguments objeto que contém os argumentos que são passados para a fonte de dados. |
| CreateEmptyDataItem() |
Cria o EmptyDataTemplate modelo no ListView controlo. |
| CreateEmptyItem() |
Cria um item vazio no ListView controlo. |
| CreateInsertItem() |
Cria um item inserido no ListView controlo. |
| CreateItem(ListViewItemType) |
Cria um ListViewItem objeto com o tipo especificado. |
| CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList) |
Cria a ListView hierarquia de controlo em grupos. |
| CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList) |
Cria a ListView hierarquia de controlo sem grupos. |
| CreateLayoutTemplate() |
Cria o contentor raiz no ListView controlo. |
| CreateSuffixArrayList(ListViewPagedDataSource, ArrayList) |
Cria um array de sufixos para ASP.NET usar quando gera o valor ClientID. |
| DataBind() |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de BaseDataBoundControl) |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| DeleteItem(Int32) |
Apaga o registo no índice especificado da fonte de dados. |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureDataBound() |
Chama o DataBind() método se a DataSourceID propriedade estiver definida e o controlo data-bound estiver marcado para exigir ligação. (Herdado de BaseDataBoundControl) |
| EnsureID() |
Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control) |
| EnsureLayoutTemplate() |
Assegura que o LayoutTemplate conteúdo é corretamente criado no ListView controlo. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExtractItemValues(IOrderedDictionary, ListViewItem, Boolean) |
Recupera os valores de cada campo declarado no item especificado e armazena-os no objeto especificado IOrderedDictionary . |
| FindControl(String, Int32) |
Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| FindPlaceholder(String, Control) |
Pesquisa no contentor especificado um controlo que tenha o identificador especificado. |
| Focus() |
Define o foco de entrada num controlo. (Herdado de Control) |
| GetData() |
Recupera um DataSourceView objeto que o controlo data-bound utiliza para realizar operações de dados. (Herdado de DataBoundControl) |
| GetDataSource() |
Recupera a IDataSource interface à qual o controlo de dados está associado, se existir. (Herdado de DataBoundControl) |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| InsertNewItem(Boolean) |
Insere o registo atual na fonte de dados. |
| InstantiateEmptyDataTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no EmptyDataTemplate template. |
| InstantiateEmptyItemTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no EmptyItemTemplate template. |
| InstantiateGroupSeparatorTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no GroupSeparatorTemplate template. |
| InstantiateGroupTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no GroupTemplate template. |
| InstantiateInsertItemTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no InsertItemTemplate template. |
| InstantiateItemSeparatorTemplate(Control) |
Preenche o objeto especificado Control usando os controlos filhos contidos no ItemSeparatorTemplate template. |
| InstantiateItemTemplate(Control, Int32) |
Preenche o objeto especificado Control usando controlos filhos de um dos ListView modelos de controlo. |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Carrega o estado das propriedades no ListView controlo que devem ser mantidas, mesmo quando a EnableViewState propriedade está definida para |
| LoadViewState(Object) |
Carrega o estado de visualização previamente guardado do ListView controlo. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MarkAsDataBound() |
Define o estado do controlo no estado de visualização como vinculado com sucesso aos dados. (Herdado de DataBoundControl) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MergeStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se um evento para o ListView controlo deve ser tratado. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Eleva o CreatingModelDataSource evento. (Herdado de DataBoundControl) |
| OnDataBinding(EventArgs) |
Eleva o DataBinding evento. (Herdado de Control) |
| OnDataBound(EventArgs) |
Eleva o DataBound evento. (Herdado de BaseDataBoundControl) |
| OnDataPropertyChanged() |
Volta a vincular o controlo ligado aos dados aos seus dados após uma das propriedades de identificação da fonte base de dados alterar. (Herdado de DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Eleva o DataSourceViewChanged evento. (Herdado de DataBoundControl) |
| OnInit(EventArgs) |
Eleva o Init evento. |
| OnItemCanceling(ListViewCancelEventArgs) |
Eleva o ItemCanceling evento. |
| OnItemCommand(ListViewCommandEventArgs) |
Eleva o ItemCommand evento. |
| OnItemCreated(ListViewItemEventArgs) |
Eleva o ItemCreated evento. |
| OnItemDataBound(ListViewItemEventArgs) |
Eleva o ItemDataBound evento. |
| OnItemDeleted(ListViewDeletedEventArgs) |
Eleva o ItemDeleted evento. |
| OnItemDeleting(ListViewDeleteEventArgs) |
Eleva o ItemDeleting evento. |
| OnItemEditing(ListViewEditEventArgs) |
Eleva o ItemEditing evento. |
| OnItemInserted(ListViewInsertedEventArgs) |
Eleva o ItemInserted evento. |
| OnItemInserting(ListViewInsertEventArgs) |
Eleva o ItemInserting evento. |
| OnItemUpdated(ListViewUpdatedEventArgs) |
Eleva o ItemUpdated evento. |
| OnItemUpdating(ListViewUpdateEventArgs) |
Eleva o ItemUpdating evento. |
| OnLayoutCreated(EventArgs) |
Eleva o LayoutCreated evento. |
| OnLoad(EventArgs) |
Trata do Load evento. (Herdado de DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Define o estado inicializado do controlo ligado a dados antes de este ser carregado. (Herdado de DataBoundControl) |
| OnPagePropertiesChanged(EventArgs) |
Eleva o PagePropertiesChanged evento. |
| OnPagePropertiesChanging(PagePropertiesChangingEventArgs) |
Eleva o PagePropertiesChanging evento. |
| OnPreRender(EventArgs) |
Trata do PreRender evento. (Herdado de BaseDataBoundControl) |
| OnSelectedIndexChanged(EventArgs) |
Eleva o SelectedIndexChanged evento. |
| OnSelectedIndexChanging(ListViewSelectEventArgs) |
Eleva o SelectedIndexChanging evento. |
| OnSorted(EventArgs) |
Eleva o Sorted evento. |
| OnSorting(ListViewSortEventArgs) |
Eleva o Sorting evento. |
| OnTotalRowCountAvailable(PageEventArgs) |
Eleva o IPageableItemContainer.TotalRowCountAvailable evento. |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| PerformDataBinding(IEnumerable) |
Vincula o ListView controlo à fonte de dados especificada. |
| PerformSelect() |
Recupera dados da fonte de dados associada. |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| RemoveItems() |
Elimina todos os controlos filhos num item ou contentor de grupo do ListView controlo. |
| Render(HtmlTextWriter) |
Renderiza o conteúdo de controlo do servidor Web para o navegador do cliente usando o objeto especificado HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda o estado das propriedades no ListView controlo que devem ser mantidas, mesmo quando a EnableViewState propriedade está definida para |
| SaveViewState() |
Guarda o estado atual de visualização do ListView controlo. |
| SelectItem(Int32) |
Seleciona o item que está em modo de edição num ListView controlo. |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetEditItem(Int32) |
Coloca o item especificado em modo de edição num ListView controlo. |
| SetPageProperties(Int32, Int32, Boolean) |
Define as propriedades de uma página de dados no ListView controlo. |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| Sort(String, SortDirection) |
Ordena o ListView controlo, dependendo da expressão de ordenação e direção especificadas. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Faz com que as alterações de estado de vista do controlo sejam rastreadas para que possam ser armazenadas no objeto do StateBag controlo. (Herdado de DataBoundControl) |
| UpdateItem(Int32, Boolean) |
Atualiza o registo no índice especificado na fonte de dados. |
| ValidateDataSource(Object) |
Verifica se o objeto ao qual um controlo databound se liga é um com o qual pode trabalhar. (Herdado de DataBoundControl) |
evento
| Name | Description |
|---|---|
| CallingDataMethods |
Ocorre quando métodos de dados estão a ser chamados. (Herdado de DataBoundControl) |
| CreatingModelDataSource |
Ocorre quando o ModelDataSource objeto está a ser criado. (Herdado de DataBoundControl) |
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| DataBound |
Ocorre depois de o controlo do servidor se ligar a uma fonte de dados. (Herdado de BaseDataBoundControl) |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| ItemCanceling |
Ocorre quando é solicitada uma operação de cancelamento, mas antes do ListView controlo cancelar a operação de inserção ou edição. |
| ItemCommand |
Ocorre quando um botão num ListView controlo é pressionado. |
| ItemCreated |
Ocorre quando um item é criado num ListView controlo. |
| ItemDataBound |
Ocorre quando um elemento de dados está ligado a dados num ListView controlo. |
| ItemDeleted |
Ocorre quando é solicitada uma operação de eliminação, após o controlo ListView eliminar o item. |
| ItemDeleting |
Ocorre quando é solicitada uma operação de eliminação, mas antes de o controlo ListView eliminar o item. |
| ItemEditing |
Ocorre quando uma operação de edição é solicitada, mas antes de o ListView item ser colocado em modo de edição. |
| ItemInserted |
Ocorre quando uma operação de inserção é solicitada, depois de o controlo ListView ter inserido o item na fonte de dados. |
| ItemInserting |
Ocorre quando é solicitada uma operação de inserção, mas antes de o ListView controlo realizar a inserção. |
| ItemUpdated |
Ocorre quando uma operação de atualização é solicitada, após o controlo ListView atualizar o item. |
| ItemUpdating |
Ocorre quando é solicitada uma operação de atualização, mas antes de o ListView controlo atualizar o item. |
| LayoutCreated |
Ocorre quando o LayoutTemplate template é criado num ListView controlo. |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| PagePropertiesChanged |
Ocorre quando as propriedades da página mudam, depois de o controlo ListView definir os novos valores. |
| PagePropertiesChanging |
Ocorre quando as propriedades da página mudam, mas antes do controlo ListView definir os novos valores. |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| SelectedIndexChanged |
Ocorre quando o botão Select de um item é clicado, depois de o ListView controlo tratar da operação de seleção. |
| SelectedIndexChanging |
Ocorre quando o botão Select de um item é carregado, mas antes do controlo ListView realizar a operação de seleção. |
| Sorted |
Ocorre quando uma operação de ordenação é solicitada, depois de o ListView controlo tratar da operação de ordenação. |
| Sorting |
Ocorre quando uma operação de ordenação é solicitada, mas antes de o ListView controlo tratar da operação de ordenação. |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para uma descrição deste elemento, veja UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para uma descrição deste elemento, veja DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control) |
| IDataBoundControl.DataKeyNames |
Obtém ou define um array que contém os nomes dos campos de chave primária dos itens que são exibidos num controlo ligado a dados. |
| IDataBoundControl.DataMember |
Obtém ou define o nome da lista de dados à qual o controlo limitado por dados se liga quando a fonte de dados contém mais do que uma lista distinta de itens de dados. |
| IDataBoundControl.DataSource |
Obtém ou define o objeto a partir do qual um controlo ligado a dados recupera a sua lista de itens de dados. |
| IDataBoundControl.DataSourceID |
Obtém ou define o ID do controlo de fonte de dados a partir do qual um controlo limitado por dados recupera a sua lista de itens de dados. |
| IDataBoundControl.DataSourceObject |
Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto. |
| IDataBoundListControl.ClientIDRowSuffix |
Obtém o nome do campo de dados cujo valor é usado para identificar unicamente cada linha de dados de um ListView controlo quando a ClientIDMode propriedade é definida para Predictable. |
| IDataBoundListControl.DataKeys |
Obtém uma coleção de valores de chave de dados que representam cada linha num controlo de dados limitado. |
| IDataBoundListControl.EnablePersistedSelection |
Obtém ou define o valor que especifica se uma linha selecionada persiste quando um utilizador passa por dados num controlo vinculado a dados. |
| IDataBoundListControl.SelectedDataKey |
Obtém o objeto data-key que contém o valor data-key para a linha selecionada num controlo data-bound. |
| IDataBoundListControl.SelectedIndex |
Obtém ou define o índice da linha selecionada num controlo data-bound. |
| IDataKeysControl.ClientIDRowSuffixDataKeys |
Obtém uma coleção dos valores de dados usados para identificar de forma única cada instância de um controlo data-bound quando ASP.NET gera o valor ClientID. |
| IExpressionsAccessor.Expressions |
Para uma descrição deste elemento, veja Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control) |
| IPageableItemContainer.MaximumRows |
Para uma descrição deste elemento, veja MaximumRows. |
| IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean) |
Para uma descrição deste elemento, veja SetPageProperties(Int32, Int32, Boolean). |
| IPageableItemContainer.StartRowIndex |
Para uma descrição deste elemento, veja StartRowIndex. |
| IPageableItemContainer.TotalRowCountAvailable |
Para uma descrição deste elemento, veja TotalRowCountAvailable. |
| IParserAccessor.AddParsedSubObject(Object) |
Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control) |
| IPersistedSelector.DataKey |
Obtém ou define o valor da chave de dados para o registo selecionado num controlo ligado a dados. |
Métodos da Extensão
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsoleto.
Permite que a seleção seja mantida em controlos de dados que suportam a seleção e a paginação. |
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo de dados que contém. |
| GetDefaultValues(INamingContainer) |
Obtém a recolha dos valores padrão para o controlo de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controlo de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |