This documentation is archived and is not being maintained.

DataKey.Item Property (String)

Gets the value of the key field with the specified field name from a DataKey object.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual Object this[
	string name
] { get; }


Type: System.String
The name of the key field for which to retrieve the key field value.

Property Value

Type: System.Object
The value of the key field with the specified field name.

Use the Item[String] property to retrieve the value of the specified key field from the DataKey object.


As an alternative, you can also use the Item[Int32] property to retrieve a key field value by index.

The following code example demonstrates how to use the Item[String] property to retrieve a key field value from a specific index in a DataKey object.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">

  void CustomerDetailsView_DataBound(Object sender, EventArgs e)

    // Get the value of the PostalCode key field.
    String value = CustomerDetailsView.DataKey["PostalCode"].ToString();

    // Display the the value of the key field.
    MessageLabel.Text = "The value of the PostalCode key field is " + value +



<html xmlns="" >

  <head runat="server">
    <title>DataKey Example</title>
    <form id="Form1" runat="server">

      <h3>DataKey Example</h3>

        <asp:detailsview id="CustomerDetailsView"
          datakeynames="CustomerID, CompanyName, PostalCode"  



        <asp:label id="MessageLabel"

        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.