AutoGeneratedField Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um campo gerado automaticamente num controlo ligado a dados. Esta 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 seguinte demonstra como criar um AutoGeneratedField objeto para um controlo personalizado que deriva desse DetailsView controlo.
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
Observações
A AutoGeneratedField classe é usada para representar um campo gerado automaticamente num controlo ligado a dados, como GridView ou DetailsView. Campos gerados automaticamente são criados por um controlo limitado por dados quando a propriedade apropriada é definida como true (por exemplo, a AutoGenerateColumns propriedade do GridView controlo, a AutoGenerateRows propriedade do DetailsView controlo, e assim sucessivamente).
Note
Campos gerados automaticamente não são adicionados à coleção de campos de um controlo ligado a dados (por exemplo, a Columns coleção do GridView controlo, a Fields coleção do DetailsView controlo, e assim sucessivamente).
A AutoGeneratedField classe destina-se a ser usada internamente por controlos ligados a dados. Ao contrário de outros campos de dados (como BoundField, CheckBoxField, TemplateField, e assim sucessivamente), a AutoGeneratedField classe não pode ser colocada declarativamente numa página como parte de uma coleção de campos. Embora possas adicionar programaticamente um AutoGeneratedField objeto a uma coleção de campos, este padrão de design deve ser evitado.
Como os campos gerados automaticamente representam a renderização automática de um campo, os controlos ligados a dados normalmente não permitem aos utilizadores modificar as propriedades dos AutoGeneratedField objetos. Se a renderização automática não for adequada às suas necessidades, defina os seus próprios campos de dados para a recolha de campos do controlo.
Construtores
| Name | Description |
|---|---|
| AutoGeneratedField(String) |
Inicializa uma nova instância da AutoGeneratedField classe com o campo de dados especificado. |
Propriedades
| Name | Description |
|---|---|
| AccessibleHeaderText |
Recebe ou define texto que é renderizado como valor de |
| ApplyFormatInEditMode |
Recebe ou define um valor que indica se a cadeia de formatação especificada pela DataFormatString propriedade é aplicada aos valores do campo quando o controlo limitado por dados que contém o BoundField objeto está em modo de edição. (Herdado de BoundField) |
| Control |
Obtém uma referência ao controlo de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de quaisquer controlos de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Recebe ou define um valor que indica se os valores de string vazios ("") são convertidos quando |
| DataField |
Obtém ou define o nome do campo de dados para se ligar ao BoundField objeto. (Herdado de BoundField) |
| DataFormatString |
Obtém ou define a cadeia que especifica o formato em que o texto alternativo de cada imagem num AutoGeneratedField objeto é renderizado. |
| DataType |
Obtém ou define o tipo de dados dos valores apresentados num AutoGeneratedField objeto. |
| DesignMode |
Obtém um valor que indica se um campo de controlo de dados está atualmente visualizado num ambiente em tempo de design. (Herdado de DataControlField) |
| FooterStyle |
Obtém ou define o estilo do rodapé do campo de controlo de dados. (Herdado de DataControlField) |
| FooterText |
Recebe ou define o texto que é exibido no elemento de rodapé de um campo de controlo de dados. (Herdado de DataControlField) |
| HeaderImageUrl |
Obtém ou define a URL de uma imagem que é exibida no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField) |
| HeaderStyle |
Obtém ou define o estilo do cabeçalho do campo de controlo de dados. (Herdado de DataControlField) |
| HeaderText |
Recebe ou define o texto que é exibido no cabeçalho de um controlo de dados. (Herdado de BoundField) |
| HtmlEncode |
Recebe ou define um valor que indica se os valores dos campos são codificados em HTML antes de serem exibidos num BoundField objeto. (Herdado de BoundField) |
| HtmlEncodeFormatString |
Recebe ou define um valor que indica se o texto criado ao aplicar a DataFormatString propriedade ao BoundField valor deve ser codificado em HTML quando é exibido. (Herdado de BoundField) |
| InsertVisible |
Recebe ou define um valor que indica se o AutoGeneratedField objeto é visível no modo de inserção. |
| IsTrackingViewState |
Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField) |
| ItemStyle |
Obtém o estilo de qualquer conteúdo baseado em texto apresentado por um campo de controlo de dados. (Herdado de DataControlField) |
| NullDisplayText |
Recebe ou define a legenda exibida para um campo quando o valor do campo é nulo. (Herdado de BoundField) |
| ReadOnly |
Recebe ou define um valor que indica se o valor do campo pode ser modificado em modo de edição. (Herdado de BoundField) |
| ShowHeader |
Recebe ou define um valor que indica se o elemento do cabeçalho de um campo de controlo de dados é renderizado. (Herdado de DataControlField) |
| SortExpression |
Obtém ou define uma expressão de ordenação que é usada por um controlo de fonte de dados para ordenar dados. (Herdado de DataControlField) |
| SupportsHtmlEncode |
Recebe um valor que indica se a codificação HTML é suportada por um BoundField objeto. (Herdado de BoundField) |
| ValidateRequestMode |
Recebe ou define um valor que determina se o controlo valida ou não a entrada do cliente. (Herdado de BoundField) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataControlField objeto através de múltiplos pedidos para a mesma página. (Herdado de DataControlField) |
| Visible |
Recebe ou define um valor que indica se um campo de controlo de dados é renderizado. (Herdado de DataControlField) |
Métodos
| Name | Description |
|---|---|
| CloneField() |
Cria uma cópia duplicada do objeto derivado atualmente 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 vazio BoundField . (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 do 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 num designer. (Herdado de BoundField) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(Control) |
Recupera o valor do campo ligado 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 a informação de estado de visualização previamente armazenada para este campo. (Herdado de BoundField) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Vincula o valor de um campo ao BoundField objeto. (Herdado de BoundField) |
| OnFieldChanged() |
Eleva o |
| SaveViewState() |
Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField) |
| ToString() |
Devolve uma cadeia que representa este DataControlField objeto. (Herdado de DataControlField) |
| TrackViewState() |
Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Determina se os controlos contidos num AutoGeneratedField objeto suportam callbacks. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a este DataControlField objeto. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de visualização previamente guardado do campo de controlo de dados. (Herdado de DataControlField) |
| IStateManager.SaveViewState() |
Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField) |
| IStateManager.TrackViewState() |
Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField) |
