AutoGeneratedField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un campo generado automáticamente en un control enlazado a datos. Esta clase no puede heredarse.

public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundField

public sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundField

type AutoGeneratedField = class
    inherit BoundField

Public NotInheritable Class AutoGeneratedField
Inherits BoundField

Herencia: Object

DataControlField

BoundField
AutoGeneratedField

Ejemplos

En el ejemplo siguiente se muestra cómo crear un AutoGeneratedField objeto para un control personalizado que deriva del DetailsView control .


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS.Controls
{

    [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    public class SimpleCustomControl : DetailsView
    {

        protected override AutoGeneratedField CreateAutoGeneratedRow(AutoGeneratedFieldProperties fieldProperties)
        {

            // Create an AutoGeneratedField object.
            AutoGeneratedField field = new AutoGeneratedField(fieldProperties.DataField);

            // Set the properties of the AutoGeneratedField using
            // the values from the AutoGeneratedFieldProperties
            // object contained in the fieldProperties parameter.
            ((IStateManager)field).TrackViewState();
            field.HeaderText = fieldProperties.Name;
            field.SortExpression = fieldProperties.Name;
            field.ReadOnly = fieldProperties.IsReadOnly;
            field.DataType = fieldProperties.Type;

            return field;
        }
    }
}


Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Web

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal), AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.DetailsView

        Protected Overrides Function CreateAutoGeneratedRow(ByVal fieldProperties As AutoGeneratedFieldProperties) As AutoGeneratedField

            ' Create an AutoGeneratedField object.
            Dim field As New AutoGeneratedField(fieldProperties.DataField)

            ' Set the properties of the AutoGeneratedField using
            ' the values from the AutoGeneratedFieldProperties 
            ' object contained in the fieldProperties parameter.
            CType(field, IStateManager).TrackViewState()
            field.HeaderText = fieldProperties.Name
            field.SortExpression = fieldProperties.Name
            field.ReadOnly = fieldProperties.IsReadOnly
            field.DataType = fieldProperties.Type

            Return field

        End Function

    End Class

End Namespace

Comentarios

La AutoGeneratedField clase se usa para representar un campo generado automáticamente en un control enlazado a datos, como GridView o DetailsView. Los campos generados automáticamente se crean mediante un control enlazado a datos cuando la propiedad adecuada se establece true en (por ejemplo, la AutoGenerateColumns propiedad del GridView control, la AutoGenerateRows propiedad del DetailsView control, etc.).

Nota

Los campos generados automáticamente no se agregan a la colección de campos de un control enlazado a datos (por ejemplo, la Columns colección para el GridView control, la Fields colección del DetailsView control, etc.).

La AutoGeneratedField clase está pensada para su uso internamente mediante controles enlazados a datos. A diferencia de otros campos de datos (como BoundField, CheckBoxField TemplateField, , etc.), la AutoGeneratedField clase no se puede colocar declarativamente en una página como parte de una colección de campos. Aunque puede agregar mediante programación un AutoGeneratedField objeto a una colección de campos, este patrón de diseño debe evitarse.

Dado que los campos generados automáticamente representan la representación automática de un campo, los controles enlazados a datos no suelen permitir a los usuarios modificar las propiedades de los AutoGeneratedField objetos. Si la representación automática no es adecuada para sus necesidades, defina sus propios campos de datos para la colección de campos del control.

Constructores

AutoGeneratedField(String)

Inicializa una nueva instancia de la clase AutoGeneratedField con el campo de datos especificado.

Propiedades

AccessibleHeaderText	Obtiene o establece el texto que se representa como el valor de la propiedad `AbbreviatedText` en algunos controles. (Heredado de DataControlField)
ApplyFormatInEditMode	Obtiene o establece un valor que indica si la cadena de formato especificada por la propiedad DataFormatString se aplica a los valores de campo cuando el control enlazado a datos que contiene el objeto BoundField está en modo de edición. (Heredado de BoundField)
Control	Obtiene una referencia al control de datos al que está asociado el objeto DataControlField. (Heredado de DataControlField)
ControlStyle	Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField. (Heredado de DataControlField)
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si los valores de cadena vacía ("") se convierten en `null` cuando los valores de campo se recuperan del origen de datos.
DataField	Obtiene o establece el nombre del campo de datos que se enlaza al objeto BoundField. (Heredado de BoundField)
DataFormatString	Obtiene o establece la cadena que especifica el formato con que se representar el texto alternativo para cada imagen de un objeto AutoGeneratedField.
DataType	Obtiene o establece el tipo de datos de los valores mostrados en un objeto AutoGeneratedField.
DesignMode	Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño. (Heredado de DataControlField)
FooterStyle	Obtiene o establece el estilo del pie de página del campo del control de datos. (Heredado de DataControlField)
FooterText	Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos. (Heredado de DataControlField)
HeaderImageUrl	Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
HeaderStyle	Obtiene o establece el estilo del encabezado del campo del control de datos. (Heredado de DataControlField)
HeaderText	Obtiene o establece el texto que se muestra en el encabezado de un control de datos. (Heredado de BoundField)
HtmlEncode	Obtiene o establece un valor que indica si los valores de campo se codifican en HTML antes de mostrarlos en un objeto BoundField. (Heredado de BoundField)
HtmlEncodeFormatString	Obtiene o establece un valor que indica si el texto que se crea aplicando la propiedad DataFormatString al valor BoundField debería mostrarse codificado como HTML. (Heredado de BoundField)
InsertVisible	Obtiene o establece un valor que indica si el objeto AutoGeneratedField es visible en modo de inserción.
IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
ItemStyle	Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos. (Heredado de DataControlField)
NullDisplayText	Obtiene o establece el título mostrado para un campo cuando el valor del campo es nulo. (Heredado de BoundField)
ReadOnly	Obtiene o establece un valor que indica si el valor del campo se puede modificar en modo de edición. (Heredado de BoundField)
ShowHeader	Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
SortExpression	Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos. (Heredado de DataControlField)
SupportsHtmlEncode	Obtiene un valor que indica si un objeto BoundField admite la codificación HTML. (Heredado de BoundField)
ValidateRequestMode	Obtiene o establece un valor que determina si el control valida la entrada de cliente o no. (Heredado de BoundField)
ViewState	Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma página. (Heredado de DataControlField)
Visible	Obtiene o establece un valor que indica si se representa un campo de control de datos. (Heredado de DataControlField)

Métodos

CloneField()	Crea una copia duplicada del objeto actual derivado de DataControlField. (Heredado de DataControlField)
CopyProperties(DataControlField)	Copia las propiedades del objeto BoundField actual al objeto DataControlField especificado. (Heredado de BoundField)
CreateField()	Crea un objeto BoundField vacío. (Heredado de BoundField)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	El objeto IOrderedDictionary especificado se rellena con los valores del objeto DataControlFieldCell especificado.
FormatDataValue(Object, Boolean)	Da formato al valor de campo especificado para una celda del objeto BoundField. (Heredado de BoundField)
GetDesignTimeValue()	Recupera el valor utilizado como valor de un campo al representar el objeto BoundField en un diseñador. (Heredado de BoundField)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Control)	Recupera el valor del campo enlazado al objeto BoundField. (Heredado de BoundField)
Initialize(Boolean, Control)	Inicializa el objeto BoundField. (Heredado de BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa el objeto TableCell especificado en el estado de fila especificado. (Heredado de BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa el objeto TableCell especificado en el estado de fila especificado. (Heredado de BoundField)
LoadViewState(Object)	Restaura la información de estado de vista almacenada previamente para este campo. (Heredado de BoundField)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataBindField(Object, EventArgs)	Enlaza el valor de un campo al objeto BoundField. (Heredado de BoundField)
OnFieldChanged()	Genera el evento `FieldChanged`. (Heredado de DataControlField)
SaveViewState()	Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField)
ToString()	Devuelve una cadena que representa este objeto DataControlField. (Heredado de DataControlField)
TrackViewState()	Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField)
ValidateSupportsCallback()	Determina si los controles incluidos en un objeto AutoGeneratedField admiten devoluciones de llamada.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtiene o establece el esquema asociado a este objeto DataControlField. (Heredado de DataControlField)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura el estado de vista que se guardó previamente del campo de control de datos. (Heredado de DataControlField)
IStateManager.SaveViewState()	Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField)
IStateManager.TrackViewState()	Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField)

Se aplica a