Partilhar via


AutoGeneratedField Classe

Definição

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
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

Confira também