Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade ListView.LayoutTemplate

Obtém ou define o conteúdo personalizado para o recipiente raiz em um ListView de controle.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (em System.Web.Extensions.dll)

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(ListView))]
public virtual ITemplate LayoutTemplate { get; set; }
<asp:ListView>
	<LayoutTemplate>ITemplate</LayoutTemplate>
</asp:ListView>

Valor de propriedade

Tipo: System.Web.UI.ITemplate
Um objeto que contém o conteúdo personalizado para o recipiente raiz em um ListView de controle. O padrão é uma referência nula (Nada no Visual Basic), que indica que essa propriedade não está definida.

Use o LayoutTemplate propriedade para definir uma interface de usuário personalizada (UI) para o recipiente da raiz da ListView de controle.

Para especificar o modelo de layout, adicione um LayoutTemplate elemento dentro do ListView de controle. Você pode adicionar o conteúdo do modelo para o LayoutTemplate elemento.

O LayoutTemplate conteúdo deve incluir um controle placeholder como, por exemplo, uma linha da tabela (tr) o elemento para os itens que são definidos pelo ItemTemplate modelo ou de grupos são definidos pelo GroupTemplate modelo. O controle do espaço reservado deve ter o runat atributo definido como "servidor" e o ID atributo definido como o valor da ItemPlaceholderID ou GroupPlaceholderID propriedade, dependendo se o ListView usando o controle de grupos.

O LayoutTemplate modelo não é necessária a ListView de controle. Você pode usar o ListView controle sem um LayoutTemplate e também sem um controle placeholder do servidor com uma identificação de conhecidos.

O exemplo a seguir mostra como definir um modelo personalizado para o contêiner de raiz no ListView de controle.

Observação de segurançaObservação sobre segurança

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para mais informações, consulte Visão Geral de Scripts Maliciosos.


<%@ 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 Templates Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Templates Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblProducts">
            <tr runat="server">
              <th runat="server">Action</th>
              <th runat="server">First Name</th>
              <th runat="server">Last Name</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ContactsDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:LinkButton ID="EditButton" runat="Server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="Server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td valign="top">
              <asp:Label ID="LastNameLabel" runat="Server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <EditItemTemplate>
          <tr style="background-color: #ADD8E6">
            <td>
              <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />&nbsp;
              <asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:TextBox ID="FirstNameTextBox" runat="server" Text='<%#Bind("FirstName") %>' 
                MaxLength="50" /><br />
            </td>
            <td>
              <asp:TextBox ID="LastNameTextBox" runat="server" Text='<%#Bind("LastName") %>' 
                MaxLength="50" /><br />
            </td>
          </tr>
        </EditItemTemplate>
      </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="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact"
        UpdateCommand="UPDATE Person.Contact
                       SET FirstName = @FirstName, LastName = @LastName
                       WHERE ContactID = @ContactID">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


O exemplo a seguir mostra como usar o ListView o controle sem definir uma LayoutTemplate o modelo no controle. Um controle de servidor com um ID conhecida também não for especificado.

<asp:ListView ID="ListView1" runat="server">
  <ItemTemplate>
    <% Eval("LastName")%>
  </ItemTemplate>
</asp:ListView>

.NET Framework

Com suporte em: 4, 3.5

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.
Mostrar: