AutoGeneratedField Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um campo gerado automaticamente em um controle com limite de dados. Essa classe não pode ser herdada.

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

Herança: Object

DataControlField

BoundField
AutoGeneratedField

Exemplos

O exemplo a seguir demonstra como criar um AutoGeneratedField objeto para um controle personalizado que deriva do DetailsView controle.


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

Comentários

A AutoGeneratedField classe é usada para representar um campo gerado automaticamente em um controle associado a dados, como GridView ou DetailsView. Os campos gerados automaticamente são criados por um controle associado a true dados quando a propriedade apropriada é definida como (por exemplo, a AutoGenerateColumns propriedade do GridView controle, a AutoGenerateRows propriedade do DetailsView controle e assim por diante).

Observação

Os campos gerados automaticamente não são adicionados à coleção de campos de um controle associado a dados (por exemplo, a Columns coleção para o GridView controle, a Fields coleção para o DetailsView controle e assim por diante).

A AutoGeneratedField classe destina-se ao uso interno por controles associados a dados. Ao contrário de outros campos de dados (como BoundField, CheckBoxFielde TemplateFieldassim por diante), a AutoGeneratedField classe não pode ser colocada declarativamente em uma página como parte de uma coleção de campos. Embora você possa adicionar programaticamente um AutoGeneratedField objeto a uma coleção de campos, esse padrão de design deve ser evitado.

Como os campos gerados automaticamente representam a renderização automática de um campo, os controles associados a dados normalmente não permitem que os usuários modifiquem as propriedades dos AutoGeneratedField objetos. Se a renderização automática não for adequada para suas necessidades, defina seus próprios campos de dados para a coleção de campos do controle.

Construtores

AutoGeneratedField(String)

Inicializa uma nova instância da classe AutoGeneratedField com o campo de dados especificado.

Propriedades

AccessibleHeaderText	Obtém ou define o texto que é renderizado como o valor da propriedade `AbbreviatedText` em alguns controles. (Herdado de DataControlField)
ApplyFormatInEditMode	Obtém ou define um valor que indica se a cadeia de caracteres de formatação especificada pela propriedade DataFormatString é aplicada aos valores de campo quando o controle associado de dados que contém o objeto BoundField está no modo de edição. (Herdado de BoundField)
Control	Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField. (Herdado de DataControlField)
ConvertEmptyStringToNull	Obtém ou define um valor que indica se valores da cadeia de caracteres vazia ("") são convertidos em `null` quando os valores de campo são recuperados da fonte de dados.
DataField	Obtém ou define o nome do campo de dados a ser associado ao objeto BoundField. (Herdado de BoundField)
DataFormatString	Obtém ou define a cadeia de caracteres que especifica o formato no qual o texto alternativo para cada imagem em um objeto AutoGeneratedField é renderizado.
DataType	Obtém ou define o tipo de dados dos valores exibidos em um objeto AutoGeneratedField.
DesignMode	Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design. (Herdado de DataControlField)
FooterStyle	Obtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField)
FooterText	Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField)
HeaderImageUrl	Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField)
HeaderStyle	Obtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField)
HeaderText	Obtém ou define o texto exibido no cabeçalho de um controle de dados. (Herdado de BoundField)
HtmlEncode	Obtém ou define um valor que indica se os valores de campo são codificados em HTML antes que eles sejam exibidos em um objeto BoundField. (Herdado de BoundField)
HtmlEncodeFormatString	Obtém ou define um valor que indica se o texto criado aplicando a propriedade DataFormatString ao valor BoundField deve ser codificado em HTML quando for exibido. (Herdado de BoundField)
InsertVisible	Obtém ou define um valor que indica se o objeto AutoGeneratedField está visível no modo de inserção.
IsTrackingViewState	Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição. (Herdado de DataControlField)
ItemStyle	Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField)
NullDisplayText	Obtém ou define a legenda exibida em um campo quando o valor do campo é null. (Herdado de BoundField)
ReadOnly	Obtém ou define um valor que indica se o valor do campo pode ser modificado no modo de edição. (Herdado de BoundField)
ShowHeader	Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado. (Herdado de DataControlField)
SortExpression	Obtém ou define uma expressão de classificação que é usada por um controle de fonte de dados para classificar os dados. (Herdado de DataControlField)
SupportsHtmlEncode	Obtém um valor que indica se a codificação HTML tiver suporte por um objeto de BoundField. (Herdado de BoundField)
ValidateRequestMode	Obtém ou define um valor que determina se o controle valida a entrada de cliente ou não. (Herdado de BoundField)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataControlField em várias solicitações da mesma página. (Herdado de DataControlField)
Visible	Obtém ou define um valor que indica se um campo de controle de dados é renderizado. (Herdado de DataControlField)

Métodos

CloneField()	Cria uma cópia duplicada do objeto atual derivado de DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto BoundField atual para o objeto DataControlField especificado. (Herdado de BoundField)
CreateField()	Cria um objeto BoundField vazio. (Herdado de BoundField)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Preenche o objeto IOrderedDictionary especificado com os valores do objeto DataControlFieldCell especificado.
FormatDataValue(Object, Boolean)	Formata o valor do campo especificado para uma célula no objeto de BoundField. (Herdado de BoundField)
GetDesignTimeValue()	Recupera o valor usado para um valor de campo ao renderizar o objeto de BoundField em um designer. (Herdado de BoundField)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(Control)	Recupera o valor do campo associado ao objeto de BoundField. (Herdado de BoundField)
Initialize(Boolean, Control)	Inicializa o objeto BoundField. (Herdado de BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa o objeto TableCell especificado no estado de linha especificado. (Herdado de BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa o objeto TableCell especificado no estado de linha especificado. (Herdado de BoundField)
LoadViewState(Object)	Restaura as informações de estado de exibição armazenadas anteriormente para esse campo. (Herdado de BoundField)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDataBindField(Object, EventArgs)	Associa o valor de um campo ao objeto de BoundField. (Herdado de BoundField)
OnFieldChanged()	Aciona o evento `FieldChanged`. (Herdado de DataControlField)
SaveViewState()	Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField)
ToString()	Retorna uma cadeia de caracteres que representa este objeto DataControlField. (Herdado de DataControlField)
TrackViewState()	Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controles contidos em um objeto AutoGeneratedField dão suporte a retornos de chamada.

Implantações explícitas de interface

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a este objeto DataControlField. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição. (Herdado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente do campo de controle de dados. (Herdado de DataControlField)
IStateManager.SaveViewState()	Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField)

Aplica-se a