Exportar (0) Imprimir
Expandir todo
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DetailsView.Fields (Propiedad)

Obtiene una colección de objetos DataControlField que representan los campos de fila explícitamente declarados en un control DetailsView.

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

public virtual DataControlFieldCollection Fields { get; }
/** @property */
public DataControlFieldCollection get_Fields ()

public function get Fields () : DataControlFieldCollection

No aplicable.

Valor de propiedad

Colección DataControlFieldCollection que contiene todos los campos de fila declarados explícitamente en el control DetailsView.

Cuando se declaran explícitamente los campos de fila para un control DetailsView, estos campos de fila se almacenan en la propiedad (colección) Fields. La colección Fields también permite administrar mediante programación la colección de filas declaradas explícitamente.

NotaNota:

Los campos de fila declarados explícitamente se pueden utilizar junto con los campos de fila generados automáticamente. Cuando se utilizan ambos, primero se representan los campos de fila declarados explícitamente, seguidos de los campos de fila generados automáticamente. Los campos de fila generados automáticamente no se agregan a la colección Fields.

Los distintos tipos de campos de fila determinan el comportamiento de las filas en el control. La tabla siguiente muestra los diferentes tipos de campos de fila que se pueden utilizar en la colección Fields.

Tipo de campo de fila

Descripción

BoundField

Muestra el valor de un campo de un origen de datos como texto.

ButtonField

Muestra un botón de comando en el control DetailsView. Esto permite mostrar una fila con un control de botón personalizado, tal como un botón Agregar o Quitar.

CheckBoxField

Muestra una casilla de verificación en el control DetailsView. Normalmente, este tipo de campo de fila se utiliza para mostrar campos con un valor booleano.

CommandField

Muestra botones de comandos integrados que permiten realizar operaciones de edición, inserción o eliminación en el control DetailsView.

HyperLinkField

Muestra el valor de un campo de un origen de datos como un hipervínculo. Este tipo de campo de fila permite enlazar un segundo campo a la dirección URL del hipervínculo.

ImageField

Muestra una imagen en el control DetailsView.

TemplateField

Muestra el contenido definido por el usuario para una fila del control DetailsView según una plantilla especificada. Este tipo de campo de fila permite crear un campo de fila personalizado.

Para declarar explícitamente los campos de fila de un control DetailsView, establezca primero la propiedad AutoGenerateRows en false. A continuación, agregue etiquetas <Fields> de apertura y cierre entre las etiquetas de apertura y cierre del control DetailsView. Finalmente, indique los campos de fila que desea incluir entre las etiquetas <Fields> de apertura y cierre. Los campos de fila se muestran en el control DetailsView en el orden en que aparecen en la colección Fields.

Aunque puede agregar campos de fila mediante programación a la colección Fields, es más fácil mostrar los campos de fila mediante declaración en el control DetailsView y, a continuación, utilizar la propiedad Visible de cada campo de fila para mostrarlo u ocultarlo.

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

El ejemplo de código siguiente muestra cómo agregar, mediante declaración, campos de fila a la colección Fields de un control DetailsView.


<%@ 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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Fields Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Fields Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          AutoGenerateRows="false"
          allowpaging="true"
          runat="server">
               
        <Fields>
         <asp:BoundField 
           DataField="CompanyName" 
           HeaderText="Company Name"/>
         <asp:BoundField 
           DataField="City" 
           HeaderText="City"/>
        </Fields>
                    
        </asp:detailsview>
        
        <!-- 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" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </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
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.