AutoGeneratedField Classe
Definição
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 associado a dados. Essa classe não pode ser herdada.
public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundFieldpublic sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundFieldtype AutoGeneratedField = class
inherit BoundFieldPublic NotInheritable Class AutoGeneratedField
Inherits BoundField- Herança
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 dados quando a propriedade apropriada é definida true como (por exemplo, a AutoGenerateColumns propriedade do GridView controle, a AutoGenerateRows propriedade para o 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 do GridView controle, a Fields coleção do DetailsView controle e assim por diante).
A AutoGeneratedField classe destina-se a ser usada internamente por controles associados a dados. Ao contrário de outros campos de dados (como BoundField, CheckBoxField, TemplateFielde assim 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
| Nome | Description |
|---|---|
| AutoGeneratedField(String) |
Inicializa uma nova instância da AutoGeneratedField classe com o campo de dados especificado. |
Propriedades
| Nome | Description |
|---|---|
| AccessibleHeaderText |
Obtém ou define o texto renderizado como o valor da |
| ApplyFormatInEditMode |
Obtém ou define um valor que indica se a cadeia de caracteres de formatação especificada pela DataFormatString propriedade é aplicada a valores de campo quando o controle associado a dados que contém o BoundField objeto está no modo de edição. (Herdado de BoundField) |
| Control |
Obtém uma referência ao controle de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de todos os controles de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se os valores de cadeia de caracteres vazias ("") são convertidos |
| DataField |
Obtém ou define o nome do campo de dados a ser associado ao BoundField objeto. (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 AutoGeneratedField objeto é renderizado. |
| DataType |
Obtém ou define o tipo de dados dos valores exibidos em um AutoGeneratedField objeto. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é exibido no momento 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 de serem exibidos em um BoundField objeto. (Herdado de BoundField) |
| HtmlEncodeFormatString |
Obtém ou define um valor que indica se o texto criado aplicando a DataFormatString propriedade ao BoundField valor deve ser codificado em HTML quando ele é exibido. (Herdado de BoundField) |
| InsertVisible |
Obtém ou define um valor que indica se o AutoGeneratedField objeto está visível no modo de inserção. |
| IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu 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 para um campo quando o valor do campo é nulo. (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 usada por um controle de fonte de dados para classificar dados. (Herdado de DataControlField) |
| SupportsHtmlEncode |
Obtém um valor que indica se a codificação HTML tem suporte por um BoundField objeto. (Herdado de BoundField) |
| ValidateRequestMode |
Obtém ou define um valor que determina se o controle valida a entrada do 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 DataControlField objeto em várias solicitações para a 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
| Nome | Description |
|---|---|
| CloneField() |
Cria uma cópia duplicada do objeto derivado atual DataControlField. (Herdado de DataControlField) |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto atual BoundField para o objeto especificado DataControlField . (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 especificado IOrderedDictionary com os valores do objeto especificado DataControlFieldCell . |
| FormatDataValue(Object, Boolean) |
Formata o valor de campo especificado para uma célula no BoundField objeto. (Herdado de BoundField) |
| GetDesignTimeValue() |
Recupera o valor usado para o valor de um campo ao renderizar o BoundField objeto 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 BoundField objeto. (Herdado de BoundField) |
| Initialize(Boolean, Control) |
Inicializa o objeto BoundField. (Herdado de BoundField) |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializa o objeto especificado TableCell para o estado da linha especificado. (Herdado de BoundField) |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inicializa o objeto especificado TableCell para o estado da linha especificado. (Herdado de BoundField) |
| LoadViewState(Object) |
Restaura as informações de estado de exibição armazenadas anteriormente para este campo. (Herdado de BoundField) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Associa o valor de um campo ao BoundField objeto. (Herdado de BoundField) |
| OnFieldChanged() |
Aciona o evento |
| SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| ToString() |
Retorna uma cadeia de caracteres que representa esse DataControlField objeto. (Herdado de DataControlField) |
| TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Determina se os controles contidos em um objeto dão AutoGeneratedField suporte a retornos de chamada. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a esse DataControlField objeto. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu 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 o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| IStateManager.TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
