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

Propriedade ListView.SelectedDataKey

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Obtém o valor de chave de dados do item selecionado em um controle ListView.

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

[BrowsableAttribute(false)]
public virtual DataKey SelectedDataKey { get; }

Valor da Propriedade

Type: System.Web.UI.WebControls.DataKey

A chave de dados do item selecionado em um controle ListView. O padrão é null, que indica que nenhum item está selecionado no momento.

Exception Condition
InvalidOperationException

Nenhuma chave de dados está especificada na propriedade DataKeyNames.

Quando o DataKeyNames propriedade for definida, o ListView controle cria um DataKey objeto para cada item no controle usando o valor ou valores de campo especificado. O DataKey objetos são adicionados ao controle de DataKeys coleção. Normalmente, o DataKeys propriedade é usada para recuperar o DataKey objeto para um item de dados específicos no ListView controle. No entanto, se você quiser recuperar apenas o DataKey objeto selecionado no momento do item, você pode usar o SelectedDataKey a propriedade como um atalho.

Usando o SelectedDataKey propriedade é igual a recuperar o DataKey de objeto o DataKeys coleção no índice especificado pelo SelectedIndex propriedade. Você também pode usar o SelectedValue propriedade para recuperar o valor de chave de dados para o item atualmente selecionado diretamente.

Se você estiver criando um ControlParameter objeto e você deseja acessar um campo de chave que não seja o primeiro campo, use o indexada SelectedDataKey propriedade no PropertyName propriedade o ControlParameter objeto.

O exemplo a seguir mostra como usar o segundo campo de chave como um parâmetro em um cenário mestre/detalhes. Um ListView controle é usado para exibir os registros da tabela de estoque de produto do banco de dados AdventureWorks. Quando um item é selecionado no ListView controle, os detalhes do produto são exibidos em outro ListView controle. ProductID é o segundo nome de chave na primeira ListView controle. Para acessar a segunda chave, o código usa o valor de ProductInventoryListView.SelectedDataKey[1] (ProductInventoryListView.SelectedDataKey(1) no Visual Basic) como o PropertyName para o ControlParameter objeto. Esse objeto de parâmetro é usado por sua vez o SqlDataSource controlar que o segundo ListView controle está vinculado.

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void ProductInventoryListView_PagePropertiesChanging(object sender, 
    PagePropertiesChangingEventArgs e)
  {
    ProductInventoryListView.SelectedIndex = -1;
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView SelectedDataKey Example</title>
    <style type="text/css">
      .header
      {
      	border: 1px solid #008080;
      	background-color: #008080;
      	color: White;
      }
      .item td { border: 1px solid #008080; }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView SelectedDataKey Example</h3>

      <asp:ListView runat="server" 
        ID="ProductInventoryListView"
        DataSourceID="ProductInventoryDataSource" 
        DataKeyNames="LocationID,ProductID" 
	      OnPagePropertiesChanging="ProductInventoryListView_PagePropertiesChanging">
        <LayoutTemplate>
          <b>Product Inventory</b>
          <br />
          <table width="400px" runat="server" id="tblProducts">
            <tr class="header" runat="server">
              <th runat="server">&nbsp;</th>
              <th runat="server">Product ID</th>
              <th runat="server">Location ID</th>
              <th runat="server">Shelf</th>
              <th runat="server">Bin</th>
              <th runat="server">Quantity</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ProductInventoryPager">
            <Fields>
              <asp:NextPreviousPagerField ShowFirstPageButton="true"
                ShowLastPageButton="true" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr class="item" runat="server">
            <td>
              <asp:ImageButton runat="server" 
                ID="SelectButton" 
                Width="15"
                Height="15"
                ImageUrl="~/images/select.jpg" 
                CommandName="Select" />
            </td>
            <td>
              <asp:Label runat="server" ID="ProductIDLabel" Text='<%#Eval("ProductID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="LocationIDLabel" Text='<%#Eval("LocationID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="ShelfLabel" Text='<%#Eval("Shelf") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="BinLabel" Text='<%#Eval("Bin") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="QuantityLabel" Text='<%#Eval("Quantity") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br /><br />

      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductDataSource">
        <LayoutTemplate>
          <b>Product Details</b>          
          <table runat="server" id="tblDetails">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="header">Product ID:</td>
            <td>
              <asp:Label runat="server" ID="ProductLabel" Text='<%#Eval("ProductID") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td class="header">Name:</td>
            <td>
              <asp:Label runat="server" ID="NameLabel" Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td class="header">Color:</td>
            <td>
              <asp:Label runat="server" ID="ColorLabel" Text='<%#Eval("Color") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td class="header">Price:</td>
            <td>
              <asp:Label runat="server" ID="ListPriceLabel" Text='<%#Eval("ListPrice", "{0:c}") %>' />
            </td>
          </tr>
        </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="ProductInventoryDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ProductID], [LocationID], [Shelf], [Bin], [Quantity]
                       FROM Production.ProductInventory">
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ProductDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ProductID], [Name], [Color], [ListPrice], [ProductNumber]
                         FROM Production.Product
                         WHERE ProductID = @ProductID
                         ORDER BY [Name]">
          <SelectParameters>
            <asp:ControlParameter Name="ProductID" 
              DefaultValue="0"
              ControlID="ProductInventoryListView" 
              PropertyName="SelectedDataKey[1]"  />
          </SelectParameters>
      </asp:SqlDataSource>

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

.NET Framework
Disponível desde 3.5
Retornar ao início
Mostrar: