DynamicField Classe
Definição
Representa um campo de dados que é exibido em um controle associado de dados que usa recursos de dados dinâmicos do ASP.NET.Represents a data field that is displayed in a data-bound control that uses ASP.NET Dynamic Data features.
public ref class DynamicField : System::Web::UI::WebControls::DataControlField, System::Web::DynamicData::IFieldFormattingOptions, System::Web::UI::IAttributeAccessor
public class DynamicField : System.Web.UI.WebControls.DataControlField, System.Web.DynamicData.IFieldFormattingOptions, System.Web.UI.IAttributeAccessor
type DynamicField = class
inherit DataControlField
interface IAttributeAccessor
interface IFieldFormattingOptions
Public Class DynamicField
Inherits DataControlField
Implements IAttributeAccessor, IFieldFormattingOptions
- Herança
- Implementações
Exemplos
Veja um exemplo de código de tempo de execução desse recurso: executar.See a run-time code example of this feature: Run.
O exemplo a seguir demonstra como usar o DynamicField objeto em um GridView controle para exibir e editar valores de uma tabela de banco de dados.The following example demonstrates how to use the DynamicField object in a GridView control to display and edit values from a database table.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Init(object sender, EventArgs e)
{
DynamicDataManager1.RegisterControl(CustomersGridView);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicField Sample</title>
<link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
<form id="form1" runat="server">
<div>
<h2><%= CustomersDataSource.TableName%> Table</h2>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" />
<asp:DynamicValidator runat="server" ID="DynamicValidator1"
ControlToValidate="CustomersGridView" Display="None" />
<asp:GridView ID="CustomersGridView" runat="server"
AutoGenerateColumns="false"
AutoGenerateEditButton="true"
AutoGenerateDeleteButton="true"
DataSourceID="CustomersDataSource"
AllowPaging="true"
AllowSorting="true"
CssClass="gridview">
<Columns>
<asp:DynamicField DataField="CustomerID" />
<asp:DynamicField DataField="FirstName" />
<asp:DynamicField DataField="LastName" />
</Columns>
</asp:GridView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="CustomersDataSource" runat="server"
TableName="Customers"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
DynamicDataManager1.RegisterControl(CustomersGridView)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicField Sample</title>
<link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
<form id="form1" runat="server">
<div>
<h2><%= CustomersDataSource.TableName%> Table</h2>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" />
<asp:DynamicValidator runat="server" ID="DynamicValidator1"
ControlToValidate="CustomersGridView" Display="None" />
<asp:GridView ID="CustomersGridView" runat="server"
AutoGenerateColumns="false"
AutoGenerateEditButton="true"
AutoGenerateDeleteButton="true"
DataSourceID="CustomersDataSource"
AllowPaging="true"
AllowSorting="true"
CssClass="gridview">
<Columns>
<asp:DynamicField DataField="CustomerID" />
<asp:DynamicField DataField="FirstName" />
<asp:DynamicField DataField="LastName" />
</Columns>
</asp:GridView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="CustomersDataSource" runat="server"
TableName="Customers"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
Comentários
Neste tópico:In this topic:
IntroduçãoIntroduction
A DynamicField classe é usada por controles vinculados a dados, como os GridView DetailsView controles e, para exibir um valor de campo que usa ASP.net dados dinâmicos recursos em páginas personalizadas.The DynamicField class is used by data-bound controls, such as the GridView and DetailsView controls, to display a field value that uses ASP.NET Dynamic Data features in custom pages.
A DynamicField classe fornece a funcionalidade que se assemelha à da BoundField classe.The DynamicField class provides functionality that resembles that of the BoundField class. No entanto, como um DynamicField objeto é usado em aplicativos dados dinâmicos, você pode aproveitar os seguintes recursos de dados dinâmicos:However, because a DynamicField object is used in Dynamic Data applications, you can take advantage of the following Dynamic Data features:
Renderizando automaticamente o controle adequado para um campo usando modelos de campo, com base no tipo de dados.Automatically rendering the proper control for a field by using field templates, based on the data type. Os modelos de campo podem ser modificados globalmente para todo o aplicativo.The field templates can be globally modified for the entire application.
Fornecendo validação de dados interna com base no esquema de banco de dado.Providing built-in data validation based on the database schema. Você também pode adicionar tipos de validação Personalizando o modelo de dados.You can also add validation types by customizing the data model.
Personalizando a renderização de dados para campos individuais usando atributos no modelo de dados ou usando a UIHint propriedade.Customizing data rendering for individual fields by using attributes in the data model or by using the UIHint property.
O DynamicField objeto renderiza cada campo usando um DynamicControl controle.The DynamicField object renders each field by using a DynamicControl control. Para especificar o campo de dados a ser exibido em um DynamicField objeto, defina a DataField propriedade como o nome do campo.To specify the data field to display in a DynamicField object, set the DataField property to the field name. Você pode aplicar uma cadeia de caracteres de formatação personalizada ao valor do campo definindo a DataFormatString propriedade.You can apply a custom formatting string to the field value by setting the DataFormatString property. Por padrão, a cadeia de caracteres de formatação é aplicada aos valores de campo somente quando o controle ligado a dados está no modo somente leitura.By default the formatting string is applied to field values only when the data-bound control is in read-only mode. Para aplicar a cadeia de caracteres de formatação aos valores exibidos enquanto o controle de vinculação de dados está no modo de edição, defina a ApplyFormatInEditMode propriedade como true .To apply the formatting string to values displayed while the data-bound control is in edit mode, set the ApplyFormatInEditMode property to true. Se um valor de campo for null , você poderá exibir uma legenda personalizada definindo a NullDisplayText propriedade.If a field value is null, you can display a custom caption by setting the NullDisplayText property. O DynamicField objeto também pode converter automaticamente valores de campo de cadeia de caracteres vazia ("") em valores nulos, definindo a ConvertEmptyStringToNull propriedade como true .The DynamicField object can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.
Sintaxe declarativaDeclarative Syntax
<asp:DynamicField
AccessibleHeaderText="string"
ApplyFormatInEditMode="true|false"
ControlStyle-BackColor="color name|#dddddd"
ControlStyle-BorderColor="color name|#dddddd"
ControlStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
Ridge|Inset|Outset"
ControlStyle-BorderWidth="size"
ControlStyle-CssClass="string"
ControlStyle-Font-Bold="true|false"
ControlStyle-Font-Italic="true|false"
ControlStyle-Font-Names="string"
ControlStyle-Font-Overline="true|false"
ControlStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
ControlStyle-Font-Strikeout="true|false"
ControlStyle-Font-Underline="true|false"
ControlStyle-ForeColor="color name|#dddddd"
ControlStyle-Height="size"
ControlStyle-Width="size"
ConvertEmptyStringToNull="true|false"
DataField="string"
DataFormatString="string"
FooterStyle-BackColor="color name|#dddddd"
FooterStyle-BorderColor="color name|#dddddd"
FooterStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
Ridge|Inset|Outset"
FooterStyle-BorderWidth="size"
FooterStyle-CssClass="string"
FooterStyle-Font-Bold="true|false"
FooterStyle-Font-Italic="true|false"
FooterStyle-Font-Names="string"
FooterStyle-Font-Overline="true|false"
FooterStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
FooterStyle-Font-Strikeout="true|false"
FooterStyle-Font-Underline="true|false"
FooterStyle-ForeColor="color name|#dddddd"
FooterStyle-Height="size"
FooterStyle-Width="size"
FooterStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
FooterStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
FooterStyle-Wrap="true|false"
HeaderImageUrl="uri"
HeaderStyle-BackColor="color name|#dddddd"
HeaderStyle-BorderColor="color name|#dddddd"
HeaderStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
Ridge|Inset|Outset"
HeaderStyle-BorderWidth="size"
HeaderStyle-CssClass="string"
HeaderStyle-Font-Bold="true|false"
HeaderStyle-Font-Italic="true|false"
HeaderStyle-Font-Names="string"
HeaderStyle-Font-Overline="true|false"
HeaderStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
HeaderStyle-Font-Strikeout="true|false"
HeaderStyle-Font-Underline="true|false"
HeaderStyle-ForeColor="color name|#dddddd"
HeaderStyle-Height="size"
HeaderStyle-Width="size"
HeaderStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
HeaderStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
HeaderStyle-Wrap="true|false"
HeaderText="string"
InsertVisible="true|false"
ItemStyle-BackColor="color name|#dddddd"
ItemStyle-BorderColor="color name|#dddddd"
ItemStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
Ridge|Inset|Outset"
ItemStyle-BorderWidth="size"
ItemStyle-CssClass="string"
ItemStyle-Font-Bold="true|false"
ItemStyle-Font-Italic="true|false"
ItemStyle-Font-Names="string"
ItemStyle-Font-Overline="true|false"
ItemStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
ItemStyle-Font-Strikeout="true|false"
ItemStyle-Font-Underline="true|false"
ItemStyle-ForeColor="color name|#dddddd"
ItemStyle-Height="size"
ItemStyle-Width="size"
ItemStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
ItemStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
ItemStyle-Wrap="true|false"
NullDisplayText="string"
ReadOnly="true|false"
ShowHeader="true|false"
SortExpression="string"
UIHint="string"
ValidationGroup="string"
Visible="true|false"
/>
<asp:DynamicField />
Construtores
| DynamicField() |
Inicializa uma nova instância da classe DynamicField.Initializes a new instance of the DynamicField class. |
Propriedades
| AccessibleHeaderText |
Obtém ou define o texto que é renderizado como o valor da propriedade |
| ApplyFormatInEditMode |
Obtém ou define um valor que indica se a cadeia de caracteres formatada especificada pela propriedade DataFormatString é aplicada ao valor do campo quando o campo de dados está no modo de edição.Gets or sets a value that indicates whether the formatted string that is specified by the DataFormatString property is applied to field value when the data field is in edit mode. |
| Column |
Obtém o objeto MetaColumn ao qual esse objeto DynamicField está associado.Gets the MetaColumn object that this DynamicField object is associated with. |
| Control |
Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado.Gets a reference to the data control that the DataControlField object is associated with. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField.Gets the style of any Web server controls contained by the DataControlField object. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se os valores de cadeia de caracteres vazia ("") são convertidos automaticamente em valores nulos quando o campo de dados é atualizado na fonte de dados.Gets or sets a value that indicates whether empty string values ("") are automatically converted to null values when the data field is updated in the data source. |
| DataField |
Obtém ou define o nome do campo de dados ao qual associar o objeto DynamicField.Gets or sets the name of the data field to bind the DynamicField object to. |
| DataFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato de exibição do valor do campo de dados.Gets or sets the string that specifies the display format for the value of the data field. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design.Gets a value indicating whether a data control field is currently viewed in a design-time environment. (Herdado de DataControlField) |
| FooterStyle |
Obtém ou define o estilo do rodapé do campo de controle de dados.Gets or sets the style of the footer of the data control field. (Herdado de DataControlField) |
| FooterText |
Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados.Gets or sets the text that is displayed in the footer item of a data control field. (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.Gets or sets the URL of an image that is displayed in the header item of a data control field. (Herdado de DataControlField) |
| HeaderStyle |
Obtém ou define o estilo do cabeçalho do campo de controle de dados.Gets or sets the style of the header of the data control field. (Herdado de DataControlField) |
| HeaderText |
Obtém ou define o texto que é exibido no cabeçalho do controle associado a dados que contém o objeto DynamicField.Gets or sets the text that is displayed in the header of the data-bound control that contains the DynamicField object. |
| HtmlEncode |
Obtém ou define um valor que indica se os valores de campo de dados são codificados em HTML antes que eles sejam exibidos em um objeto DynamicField.Gets or sets a value that indicates whether data field values are HTML-encoded before they are displayed in a DynamicField object. |
| InsertVisible |
Obtém um valor que indica se o objeto DataControlField fica visível quando o controle associado a dados pai está no modo de inserção.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode. (Herdado de DataControlField) |
| IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state. (Herdado de DataControlField) |
| ItemStyle |
Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.Gets the style of any text-based content displayed by a data control field. (Herdado de DataControlField) |
| NullDisplayText |
Obtém ou define a legenda exibida para um campo de dados quando o valor de campo é |
| ReadOnly |
Obtém o estado somente leitura do campo dinâmico.Gets the read-only state of the dynamic field. |
| ShowHeader |
Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado.Gets or sets a value indicating whether the header item of a data control field is rendered. (Herdado de DataControlField) |
| SortExpression |
Obtém ou define a expressão de classificação que é usada quando o campo de dados é usado para classificar a fonte de dados.Gets or sets the sort expression that is used when the data field is used to sort the data source by. |
| UIHint |
Obtém ou define o modelo de campo a ser usado para exibir o campo de dados.Gets or sets the field template to use for displaying the data field. |
| ValidateRequestMode |
Obtém ou define um valor que especifica se o controle valida a entrada do cliente.Gets or sets a value that specifies whether the control validates client input. |
| ValidateRequestMode |
Obtém ou define um valor que especifica se o controle valida a entrada do cliente.Gets or sets a value that specifies whether the control validates client input. (Herdado de DataControlField) |
| ValidationGroup |
Obtém o objeto ValidationGroup ao qual esse objeto DynamicField está associado.Gets the ValidationGroup object that this DynamicField object is associated with. |
| 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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page. (Herdado de DataControlField) |
| Visible |
Obtém ou define um valor que indica se um campo de controle de dados é renderizado.Gets or sets a value indicating whether a data control field is rendered. (Herdado de DataControlField) |
Métodos
| CloneField() |
Cria uma cópia duplicada do objeto atual derivado de DataControlField.Creates a duplicate copy of the current DataControlField-derived object. (Herdado de DataControlField) |
| ConfigureDynamicControl(DynamicControl) |
Fornece um mecanismo para modificar um objeto DynamicControl que foi criado pelo método InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).Provides a mechanism to modify a DynamicControl object that was created by the InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) method. |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto DynamicField atual para o objeto DataControlField especificado.Copies the properties of the current DynamicField object to the specified DataControlField object. |
| CreateDynamicControl() |
Fornece um mecanismo para classes que derivam de DynamicField para substituir como um objeto DynamicControl é criado.Provides a mechanism for classes that derive from DynamicField to override how a DynamicControl object is created. |
| CreateField() |
Cria e retorna uma nova instância da classe DynamicField.Creates and returns a new instance of the DynamicField class. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrai o valor do campo de dados da célula da tabela a seguir e adiciona o valor ao dicionário especificado.Extracts the value of the data field from the current table cell and adds the value to the specified dictionary. |
| GetAttribute(String) |
Recupera o valor do atributo especificado.Retrieves the specified attribute value. |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| Initialize(Boolean, Control) |
Executa a inicialização de instância básica para um campo de controle de dados.Performs basic instance initialization for a data control field. (Herdado de DataControlField) |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Adiciona texto ou controles à célula especificada.Adds text or controls to the specified cell. |
| LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.Restores the data source view's previously saved view state. (Herdado de DataControlField) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| OnFieldChanged() |
Aciona o evento |
| 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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server. (Herdado de DataControlField) |
| SetAttribute(String, String) |
Define um atributo associado ao objeto DynamicField.Sets an attribute that is associated with the DynamicField object. |
| ToString() |
Retorna uma cadeia de caracteres que representa este objeto DataControlField.Returns a string that represents this DataControlField object. (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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Quando substituído em uma classe derivada, sinaliza que os controles contidos por um campo dão suporte a retornos de chamada.When overridden in a derived class, signals that the controls contained by a field support callbacks. (Herdado de DataControlField) |
Implantações explícitas de interface
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a este objeto DataControlField.Gets or sets the schema associated with this DataControlField object. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state. (Herdado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente do campo de controle de dados.Restores the data control field's previously saved view state. (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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server. (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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page. (Herdado de DataControlField) |
Métodos de Extensão
| ConvertEditedValue(IFieldFormattingOptions, String) |
Retorna o valor fornecido por um usuário para um controle que está sendo validado.Returns the value provided by a user for a control that is being validated. |
| FormatEditValue(IFieldFormattingOptions, Object) |
Formata o valor do campo especificado usando as opções de formatação especificadas.Formats the specified field value by using the specified formatting options. |
| FormatValue(IFieldFormattingOptions, Object) |
Formata o valor do campo especificado usando as opções de formatação especificadas.Formats the specified field value by using the specified formatting options. |