ListView.DataKeyNames Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Hiermee haalt u een matrix op die de namen bevat van de primaire-sleutelvelden voor de items die in een ListView besturingselement worden weergegeven.

public:
 virtual property cli::array <System::String ^> ^ DataKeyNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.StringArrayConverter))]
public virtual string[] DataKeyNames { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.StringArrayConverter))>]
member this.DataKeyNames : string[] with get, set
Public Overridable Property DataKeyNames As String()

Waarde van eigenschap

String[]

Een matrix met de namen van de primaire-sleutelvelden voor de items die in een ListView besturingselement worden weergegeven.

Kenmerken
TypeConverterAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de DataKeyNames eigenschap gebruikt om het sleutelveld van de gegevensbron op te geven.

<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>

<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>

Opmerkingen

Gebruik de DataKeyNames eigenschap om het veld of de velden op te geven die de primaire sleutel van de gegevensbron vertegenwoordigen. Als u deze eigenschap declaratief wilt instellen, gebruikt u een door komma's gescheiden lijst met veldnamen.

Wanneer de DataKeyNames eigenschap is ingesteld, wordt de ListView verzameling automatisch gevuld DataKeys met de waarden uit het opgegeven veld of de opgegeven velden. Dit biedt een handige manier om toegang te krijgen tot de primaire sleutels van elk item.

Important

In ListView het besturingselement worden sleutelveldwaarden opgeslagen in het veld Control State. Als deze waarden gevoelige informatie bevatten, raden we u aan om versleuteling van de weergavestatus in te schakelen door de ViewStateEncryptionMode eigenschap in te stellen op ViewStateEncryptionMode.Always.

U moet de DataKeyNames eigenschap instellen voor de functies voor automatisch bijwerken en verwijderen van het ListView besturingselement. De waarden van deze sleutelvelden worden doorgegeven aan het besturingselement voor de gegevensbron om het item bij te werken of te verwijderen.

Velden die zijn opgegeven als gegevenssleutels met behulp van de DataKeyNames eigenschap, worden tijdens het bijwerken en verwijderen doorgegeven aan het gegevensbronbeheer met behulp van de Keys verzameling. Gegevenssleutelvelden worden doorgegeven aan het besturingselement voor gegevensbronnen, zelfs als ze niet zijn gebonden aan besturingselementen in een sjabloon.

Van toepassing op

Zie ook