Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Personas que lo han encontrado útil: 2 de 5 - Valorar este tema

GridView.DataKeyNames (Propiedad)

.NET Framework 2.0
Obtiene o establece una matriz que contiene los nombres de los campos de clave principal de los elementos mostrados en un control GridView.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

C#
C++
VB
Copiar 
[TypeConverterAttribute(typeof(StringArrayConverter))] 
public virtual string[] DataKeyNames { get; set; }
J#
Copiar 
/** @property */
public String[] get_DataKeyNames ()

/** @property */
public void set_DataKeyNames (String[] value)
JScript
Copiar 
public function get DataKeyNames () : String[]

public function set DataKeyNames (value : String[])
XAML
Copiar 
No aplicable.

Valor de propiedad

Matriz que contiene los nombres de los campos de clave principal de los elementos mostrados en un control GridView.

Utilice la propiedad DataKeyNames para especificar el campo o campos que representan la clave principal del origen de datos.

NotaNota:

Para establecer esta propiedad mediante declaración, utilice una lista de nombres de campos separados por comas.

Cuando se establece la propiedad DataKeyNames, el control GridView rellena automáticamente su colección DataKeys con los valores del campo o de los campos especificados, lo que representa una manera práctica de tener acceso a las claves principales de cada fila.

NotaNota:

El control GridView almacena estos valores de campo de clave en el estado de control. Si estos valores contienen información confidencial, se recomienda encarecidamente que habilite el cifrado del estado de vista estableciendo la propiedad ViewStateEncryptionMode en ViewStateEncryptionMode.Always.

Al utilizar columnas de campos generados automáticamente (estableciendo la propiedad AutoGenerateColumns en true), el control GridView garantiza al instante que las columnas de campos generados automáticamente que corresponden al campo o los campos especificados en la propiedad DataKeyNames son de sólo lectura.

NotaNota:

Debe establecer la propiedad DataKeyNames para que funcionen las características de actualización y eliminación automática del control GridView. Los valores de estos campos de clave se pasan al control de origen de datos para compararlos con los de la fila que se va a actualizar o eliminar.

Si la propiedad Visible de un campo de columna se establece en false, la columna no se muestra en el control GridView y los datos de la columna no vuelven al cliente. Si desea que los datos de una columna que no es visible realicen una acción de ida y vuelta, agregue el nombre de campo a la propiedad DataKeyNames.

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad DataKeyNames para especificar el campo de clave del origen de datos.

C#
VB
Copiar 

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

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
¿Le ha resultado útil?
(Caracteres restantes: 1500)