Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Propriedade ListView.DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave primária para os itens exibidos em um controle de ListView .

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

[TypeConverterAttribute(typeof(StringArrayConverter))]
public virtual string[] DataKeyNames { get; set; }
<asp:ListView DataKeyNames="value" />

Valor de propriedade

Tipo: System.String[]
Uma matriz que contém os nomes dos campos de chave primária para os itens exibidos em um controle de ListView .

Use a propriedade de DataKeyNames para especificar o campo ou campos que representam a chave primária da fonte de dados. Para definir declarativamente essa propriedade, use uma lista separada por vírgulas de nomes de campos.

Quando a propriedade de DataKeyNames é definida, o controle de ListView preenche automaticamente sua coleção de DataKeys com os valores de campo ou campos especificados. Isso fornece uma maneira conveniente para acessar as chaves primárias de cada item.

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

Os valores dos campos dos armazenamentos de controle de ListView no campo estado de controle. Se esses valores contêm informações confidenciais, é recomendável que você habilita a criptografia de estado de exibição definindo a propriedade de ViewStateEncryptionMode a ViewStateEncryptionMode.Always.

Você deve definir a propriedade de DataKeyNames para o automático que atualiza e que exclui recursos de controle de ListView para trabalhar. Os valores desses campos são passados para o controle da fonte de dados para corresponder ao item para atualizar ou excluir.

Campos que são especificados como as chaves de dados usando a propriedade de DataKeyNames são passadas para o controle da fonte de dados durante a atualização e a operações de exclusão usando a coleção de Keys . Os campos de dados são passados para o controle da fonte de dados mesmo se não são associados a controles em um modelo.

O exemplo a seguir mostra como usar a propriedade de DataKeyNames para especificar o campo chave da fonte de dados.


<asp:ListView runat="server" 
  ID="EmployeesListView"
  OnItemCommand="EmployeesListView_OnItemCommand"
  DataSourceID="EmployeesDataSource" 
  DataKeyNames="EmployeeID">
  <LayoutTemplate>
    <table runat="server" id="tblEmployees" 
           cellspacing="0" cellpadding="1" width="440px" border="1">
      <tr id="itemPlaceholder" runat="server"></tr>
    </table>
    <asp:DataPager ID="EmployeesDataPager" runat="server" PageSize="10">
      <Fields>
        <asp:NumericPagerField />
      </Fields>
    </asp:DataPager>
  </LayoutTemplate>
  <ItemTemplate>
    <tr runat="server">
      <td>
        <asp:Label runat="server" ID="NameLabel" 
          Text='<%#Eval("LastName") + ", " + Eval("FirstName") %>' />
      </td>
      <td style="width:80px">
        <asp:LinkButton runat="server" 
          ID="SelectEmployeeButton" 
          Text="Add To List" 
          CommandName="AddToList" 
          CommandArgument='<%#Eval("LastName") + ", " + Eval("FirstName") %>' />
      </td>
    </tr>
  </ItemTemplate>
</asp:ListView>

<br /><br />
<b>Selected Employees:</b><br />
<asp:ListBox runat="server" ID="SelectedEmployeesListBox" Rows="10" Width="300px" />

<!-- 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="EmployeesDataSource" runat="server" 
  ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
  SelectCommand="SELECT [EmployeeID], [FirstName], [LastName]
                 FROM HumanResources.vEmployee
                 ORDER BY [LastName], [FirstName], [EmployeeID]">
</asp:SqlDataSource>


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

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 do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft