DynamicControl Classe
Definição
Exibe o conteúdo que é definido para o campo em controles associado a dados usando os recursos de dados dinâmicos do ASP.NET.Displays the content that is defined for the field in templated data-bound controls, using ASP.NET Dynamic Data features.
public ref class DynamicControl : System::Web::UI::Control, System::Web::DynamicData::IFieldFormattingOptions, System::Web::DynamicData::IFieldTemplateHost, System::Web::UI::IAttributeAccessor
[System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.ico")]
public class DynamicControl : System.Web.UI.Control, System.Web.DynamicData.IFieldFormattingOptions, System.Web.DynamicData.IFieldTemplateHost, System.Web.UI.IAttributeAccessor
[System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.bmp")]
public class DynamicControl : System.Web.UI.Control, System.Web.DynamicData.IFieldFormattingOptions, System.Web.DynamicData.IFieldTemplateHost, System.Web.UI.IAttributeAccessor
[<System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.ico")>]
type DynamicControl = class
inherit Control
interface IAttributeAccessor
interface IFieldTemplateHost
interface IFieldFormattingOptions
[<System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.bmp")>]
type DynamicControl = class
inherit Control
interface IAttributeAccessor
interface IFieldTemplateHost
interface IFieldFormattingOptions
Public Class DynamicControl
Inherits Control
Implements IAttributeAccessor, IFieldFormattingOptions, IFieldTemplateHost
- Herança
- Atributos
- 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 DynamicControl controle em um ListView controle para exibir, inserir, excluir e editar valores de uma tabela de banco de dados.The following example demonstrates how to use the DynamicControl control in a ListView control to display, insert, delete and edit values from a database table. É importante observar que, para que a operação de inserção funcione, a IsDbGenerated propriedade das rowguid ModifiedDate colunas e é definida como true .It is important to notice that in order to make the insert operation to work, the IsDbGenerated property of the rowguid and ModifiedDate columns are set to true.
<%@ 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(ListView1);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="InsertValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Insert" />
<asp:DynamicValidator runat="server" ID="InsertValidator"
ControlToValidate="ListView1" ValidationGroup="Insert" Display="None" />
<asp:ValidationSummary ID="EditValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Edit" />
<asp:DynamicValidator runat="server" ID="EditValidator"
ControlToValidate="ListView1" ValidationGroup="Edit" Display="None" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit"
Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete"
Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update"
Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit"
ValidationGroup="Edit" DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert"
Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="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(ListView1)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="InsertValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Insert" />
<asp:DynamicValidator runat="server" ID="InsertValidator"
ControlToValidate="ListView1" ValidationGroup="Insert" Display="None" />
<asp:ValidationSummary ID="EditValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Edit" />
<asp:DynamicValidator runat="server" ID="EditValidator"
ControlToValidate="ListView1" ValidationGroup="Edit" Display="None" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit"
Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete"
Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update"
Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit"
ValidationGroup="Edit" DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert"
Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
Comentários
Neste tópico:In this topic:
IntroduçãoIntroduction
O DynamicControl controle é usado por controles vinculados a dados de modelo, como FormView ou ListView , para exibir um campo de dados que usa ASP.net dados dinâmicos recursos em uma página personalizada.The DynamicControl control is used by templated data-bound controls, such as FormView or ListView, to display a data field that uses ASP.NET Dynamic Data features in a custom page. Você também pode usar um DynamicControl controle em um TemplateField campo de um GridView controle ou DetailsView .You can also use a DynamicControl control in a TemplateField field of a GridView or a DetailsView control.
O DynamicControl controle fornece funcionalidade semelhante à do DynamicField campo.The DynamicControl control provides functionality that is similar to that of the DynamicField field. No entanto, como o DynamicControl controle só é usado dentro de modelos, ele oferece mais flexibilidade no controle de como os dados são exibidos, já que você pode adicionar outros elementos HTML em todo o campo.However, because the DynamicControl control is only used inside templates, it gives you more flexibility in controlling how the data is displayed since you can add other HTML elements around the field. Ao usar um DynamicControl controle, você pode aproveitar os seguintes recursos de dados dinâmicos:When you use a DynamicControl control, 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.
Para especificar o campo a ser exibido em um DynamicControl controle, defina a DataField propriedade como o nome do campo.To specify the field to display in a DynamicControl control, 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 DynamicControl controle também pode converter automaticamente valores de campo de cadeia de caracteres vazia ("") em valores nulos, definindo a ConvertEmptyStringToNull propriedade como true .The DynamicControl control can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.
O DynamicControl controle dá suporte a modos de exibição diferentes.The DynamicControl control supports different display modes. Para especificar o modo no qual exibir o DynamicControl controle, defina a Mode propriedade.To specify the mode in which to display the DynamicControl control, set the Mode property. A tabela a seguir mostra os modos diferentes.The following table shows the different modes.
ReadOnly para o modo de exibição.ReadOnly for display mode. Isso impede que o usuário modifique os valores de um registro ou de um campo de dados.This prevents the user from modifying the values of a record or a data field. Ele pode ser usado em qualquer um dos modelos.It can be used in any of the templates.
Edit para o modo de edição.Edit for edit mode. Isso permite que os usuários atualizem os valores de um registro existente.This enables users to update the values of an existing record. Ele é usado no modelo de edição (normalmente denominado EditItemTemplate ).It is used in the edit template (typically named EditItemTemplate).
Insert para o modo de inserção.Insert for insert mode. Isso permite que os usuários insiram valores para um novo registro.This enables users to enter values for a new record. Ele é usado no modelo de inserção (normalmente denominado InsertItemTemplate ).It is used in the insert template (typically named InsertItemTemplate).
Você pode ocultar um DynamicControl controle em um controle vinculado a dados definindo a Visible propriedade como false .You can hide a DynamicControl control in a data-bound control by setting the Visible property to false.
Sintaxe declarativaDeclarative Syntax
<asp:DynamicControl
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
CssClass="string"
DataField="string"
DataFormatString="string"
EnableViewState="True|False"
HtmlEncode="True|False"
ID="string"
Mode="Edit|Insert|ReadOnly"
NullDisplayText="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
UIHint="string"
ValidationGroup="string"
Visible="True|False"
>
</asp:DynamicControl>
Construtores
| DynamicControl() |
Inicializa uma nova instância da classe DynamicControl.Initializes a new instance of the DynamicControl class. |
| DynamicControl(DataBoundControlMode) |
Inicializa uma nova instância da classe DynamicControl com o modo especificado.Initializes a new instance of the DynamicControl class with the specified mode. |
Propriedades
| Adapter |
Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control. (Herdado de Control) |
| ApplyFormatInEditMode |
Obtém ou define um valor que indica se a cadeia de caracteres de formatação especificada pela propriedade DataFormatString é aplicada ao valor do campo quando o campo está no modo de edição.Gets or sets a value that indicates whether the formatting string specified by the DataFormatString property is applied to field values when the field is in edit mode. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Herdado de Control) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding. (Herdado de Control) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created. (Herdado de Control) |
| ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property. (Herdado de Control) |
| Column |
Obtém ou define o objeto de coluna associado ao controle.Gets or sets the column object that is associated with the control. |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request. (Herdado de Control) |
| Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Herdado de Control) |
| 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. |
| CssClass |
Obtém ou define a classe CSS (Folha de Estilos em Cascata) que especifica os estilos de exibição para o conteúdo do controle DynamicControl.Gets or sets the Cascading Style Sheet (CSS) class that specifies the display styles for the DynamicControl control content. |
| DataField |
Obtém ou define o nome do campo de dados ao qual o controle DynamicControl está associado.Gets or sets the name of the data field that the DynamicControl control is bound to. |
| DataFormatString |
Obtém ou define uma cadeia de caracteres que especifica o formato de exibição do valor do campo.Gets or sets a string that specifies the display format for the value of the field. |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl. (Herdado de Control) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface. (Herdado de Control) |
| EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control. (Herdado de Control) |
| EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Essa propriedade é somente leitura.This property is read-only. (Herdado de Control) |
| FieldTemplate |
Obtém o modelo de campo que é criado para o controle DynamicControl.Gets the field template that is created for the DynamicControl control. |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.Gets a value indicating whether the current server control's child controls have any saved view-state settings. (Herdado de Control) |
| HtmlEncode |
Obtém ou define um valor que indica se os dados para o controle são codificados em HTML antes da renderização.Gets or sets a value that indicates whether the data for the control is HTML-encoded before rendering. |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers. (Herdado de Control) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index. (Herdado de Control) |
| Mode |
Obtém ou define o modo de renderização.Gets or sets the rendering mode. |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value. (Herdado de Control) |
| NullDisplayText |
Obtém ou define a legenda exibida para um campo de dados quando o valor de campo é |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy. (Herdado de Control) |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Herdado de Control) |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface. (Herdado de Control) |
| SkinID |
Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control. (Herdado de Control) |
| Table |
Obtém o objeto da tabela associada ao controle.Gets the table object that is associated with the control. |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control. (Herdado de Control) |
| UIHint |
Obtém ou define o nome do modelo de campo usado para renderizar o campo de dados.Gets or sets the name of the field template that is used to render the data field. |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control. (Herdado de Control) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Herdado de Control) |
| ValidationGroup |
Obtém ou define o nome do grupo de validação para o controle.Gets or sets the validation group name for the control. |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control. (Herdado de Control) |
| Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.Gets or sets a value that indicates whether a server control is rendered as UI on the page. (Herdado de Control) |
Métodos
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.Deletes the view-state and control-state information for all the server control's child controls. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Herdado de Control) |
| CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control. (Herdado de Control) |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls. (Herdado de Control) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned. (Herdado de Control) |
| 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) |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para um controle.Sets input focus to a control. (Herdado de Control) |
| GetAttribute(String) |
Recupera o valor de atributo usando a chave especificada.Retrieves the attribute value by using the specified key. |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle.Gets design-time data for a control. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control. (Herdado de Control) |
| HasControls() |
Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method. (Herdado de Control) |
| LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method. (Herdado de Control) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.Determines whether the event for the server control is passed up the page's UI server control hierarchy. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding.Raises the DataBinding event. (Herdado de Control) |
| OnInit(EventArgs) | |
| OnLoad(EventArgs) |
Aciona o evento Load.Raises the Load event. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender.Raises the PreRender event. (Herdado de Control) |
| OnUnload(EventArgs) |
Aciona o evento Unload.Raises the Unload event. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o conteúdo do controle DynamicControl do navegador do cliente usando o objeto HtmlTextWriter especificado.Renders the DynamicControl control content to the client's browser by using the specified HtmlTextWriter object. |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object. (Herdado de Control) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.Saves any server control state changes that have occurred since the time the page was posted back to the server. (Herdado de Control) |
| SaveViewState() |
Salva alterações de estado de exibição do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.Saves any server control view-state changes that have occurred since the time the page was posted back to the server. (Herdado de Control) |
| SetAttribute(String, String) |
Define o atributo especificado para o valor especificado.Sets the specified attribute to the specified value. |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle.Sets design-time data for a control. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |
| TrackViewState() |
Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Esse objeto é acessível por meio da propriedade ViewState.This object is accessible through the ViewState property. (Herdado de Control) |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source. (Herdado de Control) |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle. (Herdado de Control) |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object. (Herdado de Control) |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering. (Herdado de Control) |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory. (Herdado de Control) |
Implantações explícitas de interface
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions. (Herdado de Control) |
| IFieldTemplateHost.FormattingOptions |
Para obter uma descrição desse membro, confira FormattingOptions.For a description of this member, see FormattingOptions. |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object). (Herdado de Control) |
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. |
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control. |
| 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. |