Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe DataControlField

 

Serve como a classe base para todos os dados campo tipos de controle, que representam uma coluna de dados em controles ligados a dados tabulares como DetailsView e GridView.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)


[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public abstract class DataControlField : IStateManager, IDataSourceViewSchemaAccessor

NomeDescrição
System_CAPS_protmethodDataControlField()

Inicializa uma nova instância da classe DataControlField.

NomeDescrição
System_CAPS_pubpropertyAccessibleHeaderText

Obtém ou define o texto que é processado como o AbbreviatedText valor de propriedade em alguns controles.

System_CAPS_protpropertyControl

Obtém uma referência ao controle de dados que o DataControlField objeto está associado.

System_CAPS_pubpropertyControlStyle

Obtém o estilo de qualquer servidor Web contido o DataControlField objeto.

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se um campo de controle de dados no momento é exibido em um ambiente de tempo de design.

System_CAPS_pubpropertyFooterStyle

Obtém ou define o estilo do rodapé do campo de controle de dados.

System_CAPS_pubpropertyFooterText

Obtém ou define o texto que é exibido no item de rodapé de um campo de controle de dados.

System_CAPS_pubpropertyHeaderImageUrl

Obtém ou define a URL de uma imagem que é exibida no item de cabeçalho de um campo de controle de dados.

System_CAPS_pubpropertyHeaderStyle

Obtém ou define o estilo do cabeçalho do campo de controle de dados.

System_CAPS_pubpropertyHeaderText

Obtém ou define o texto que é exibido no item de cabeçalho de um campo de controle de dados.

System_CAPS_pubpropertyInsertVisible

Obtém um valor que indica se o DataControlField objeto fica visível quando o controle ligado a dados pai está no modo de inserção.

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o DataControlField objeto é salvar alterações no estado de exibição.

System_CAPS_pubpropertyItemStyle

Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.

System_CAPS_pubpropertyShowHeader

Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é processado.

System_CAPS_pubpropertySortExpression

Obtém ou define uma expressão de classificação que é usada por um controle de fonte de dados para classificar os dados.

System_CAPS_protpropertyValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.

System_CAPS_protpropertyViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de uma DataControlField objeto entre várias solicitações para a mesma página.

System_CAPS_pubpropertyVisible

Obtém ou define um valor que indica se um campo de dados de controle é processado.

NomeDescrição
System_CAPS_protmethodCloneField()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Cria uma cópia duplicada de atual DataControlField-objeto derivado.

System_CAPS_protmethodCopyProperties(DataControlField)

Copia as propriedades do atual DataControlField-objeto derivado especificado DataControlField objeto.

System_CAPS_protmethodCreateField()

Quando substituído em uma classe derivada, cria um vazio DataControlField-objeto derivado.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrai o valor do campo de controle de dados da célula da tabela atual e adiciona o valor especificado IDictionary coleção.

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInitialize(Boolean, Control)

Executa a inicialização de instância básica para um campo de controle de dados.

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Adiciona texto ou controles à coleção controls da célula.

System_CAPS_protmethodLoadViewState(Object)

Restaura a exibição de fonte de dados salvo anteriormente o estado de exibição.

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do atual Object.(Herdado de Object.)

System_CAPS_protmethodOnFieldChanged()

Gera o FieldChanged evento.

System_CAPS_protmethodSaveViewState()

Salva as alterações feitas a DataControlField Exibir estado desde a hora em que a página foi postada no servidor.

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa este DataControlField objeto.(Substitui o Object.ToString().)

System_CAPS_protmethodTrackViewState()

Faz com que o DataControlField objeto para controlar alterações em seu estado de exibição para que eles podem ser armazenados no controle do ViewState propriedade e persistentes entre solicitações para a mesma página.

System_CAPS_pubmethodValidateSupportsCallback()

Quando substituído em uma classe derivada, indica que os controles contidos por um campo de suporte a retornos de chamada.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Restaura o estado de exibição salvo anteriormente do campo de controle de dados.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Salva as alterações feitas a DataControlField Exibir estado desde a hora em que a página foi postada no servidor.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Faz com que o DataControlField objeto para controlar alterações em seu estado de exibição para que eles podem ser armazenados no controle do ViewState propriedade e persistentes entre solicitações para a mesma página.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém ou define o esquema associado a esse DataControlField objeto.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um valor que indica se o DataControlField objeto é salvar alterações no estado de exibição.

O DataControlField classe serve como a classe base para todos os dados de tipos de campo de controle. Campos de controle de dados são usados pelos controles ligados a dados para representar um campo de dados, semelhantes a como uma DataGridColumn objeto representa um tipo de coluna a DataGrid controle.

Use as classes que derivam de DataControlField para controlar como um campo de dados é exibido em um controle ligado a dados, como DetailsView ou GridView. A tabela a seguir lista os tipos de campo de controle de dados diferentes fornecidos pelo ASP.NET.

Tipo de campo de coluna

Descrição

BoundField

Exibe o valor de um campo em uma fonte de dados como texto.

ButtonField

Exibe um botão de comando em um controle ligado a dados. Dependendo do controle, isso permite que você exibir uma linha ou uma coluna com um controle de botão personalizado, como um complemento ou um botão Remover.

CheckBoxField

Exibe uma caixa de seleção em um controle ligado a dados. Esse tipo de campo de controle de dados geralmente é usado para exibir campos com um valor booleano.

CommandField

Exibe o comando interno botões para executar a edição, inserção ou exclusão de operações em um controle ligado a dados.

HyperLinkField

Exibe o valor de um campo em uma fonte de dados como um hiperlink. Esse tipo de campo de controle de dados permite associar um segundo campo URL do hiperlink.

ImageField

Exibe uma imagem em um controle ligado a dados.

TemplateField

Exibe conteúdo definido pelo usuário em um controle ligado a dados de acordo com um modelo especificado.

Você também pode estender o DataControlField e BoundField classes para criar seu próprio controle de dados em tipos de campo.

O DataControlField classe fornece várias propriedades que determinam como os elementos de interface do usuário são apresentados no controle ligado a dados. Nem todo controle usa cada propriedade de campo de controle de dados disponíveis durante a renderização de uma interface do usuário. Por exemplo, o DetailsView controle, que exibe os campos de controle de dados como linhas, inclui um item de cabeçalho para cada campo de controle de dados, mas nenhum item de rodapé. Portanto, o FooterText e FooterStyle propriedades são ignoradas pelo DetailsView controle. O GridView controlar, no entanto, usa a FooterText e FooterStyle propriedades se o ShowFooter está definida como true. Da mesma forma, as propriedades de campo de controle de dados afetam a apresentação dos elementos de interface do usuário, dependendo de qual é o elemento. O ItemStyle propriedade sempre é aplicada ao campo. Se o tipo derivado de DataControlField contém um controle, como na ButtonField ou CheckBoxField classes, o ControlStyle propriedade é aplicada ao campo.

O exemplo de código a seguir demonstra como usar BoundField e ButtonField objetos, que são derivados de DataControlField, para exibir linhas em uma DetailsView controle. O DetailsView controle tem o AutoGenerateRows definida como false, que permite exibir um subconjunto dos dados retornados por de SelectCommand propriedade.

<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <asp:sqldatasource
      id="SqlDataSource1"
      runat="server"
      connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
      selectcommand="Select * From Employees">
    </asp:sqldatasource>

    <asp:detailsview
      id="DetailsView1"
      runat="server"
      allowpaging="True"
      datasourceid="SqlDataSource1"
      height="208px"
      width="264px"
      autogeneraterows="False">
        <fields>

          <asp:boundfield
            sortexpression="LastName"
            datafield="LastName"
            headertext="LastName">
              <itemstyle backcolor="Yellow">
              </itemstyle>
          </asp:boundfield>

          <asp:boundfield
            sortexpression="FirstName"
            datafield="FirstName"
            headertext="FirstName">
              <itemstyle forecolor="#C00000">
              </itemstyle>
          </asp:boundfield>

          <asp:buttonfield
            text="TestButton"
            buttontype="Button">
          </asp:buttonfield>

        </fields>
    </asp:detailsview>

  </form>
</body>
</html>

O exemplo de código a seguir demonstra como estender o BoundField classe para criar um campo personalizado associado que pode ser usado em um GridView controle. Como o CheckBoxField classe, a RadioButtonField classe representa uma coluna de true ou false dados. No entanto, embora os dados que o CheckBoxField classe está vinculada a pode ser qualquer conjunto de true ou false valores, o conjunto de dados que o RadioButtonField classe está vinculada a só pode ter um true valor a qualquer momento. Este exemplo demonstra como implementar a ExtractValuesFromCell e InitializeCell métodos, dois métodos importantes de todas as classes derivadas de DataControlField.

namespace Samples.AspNet.CS {

  using System;
  using System.Collections;
  using System.Collections.Specialized;
  using System.ComponentModel;
  using System.Security.Permissions;
  using System.Web;
  using System.Web.UI;
  using System.Web.UI.WebControls;

  [AspNetHostingPermission(SecurityAction.Demand, 
      Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class RadioButtonField : CheckBoxField {

    public RadioButtonField() {
    }

    // Gets a default value for a basic design-time experience. 
    // Since it would look odd, even at design time, to have 
    // more than one radio button selected, make sure that none
    // are selected.
    protected override object GetDesignTimeValue() {
        return false;
    }
    // This method is called by the ExtractRowValues methods of 
    // GridView and DetailsView. Retrieve the current value of the 
    // cell from the Checked state of the Radio button.
    public override void ExtractValuesFromCell(IOrderedDictionary dictionary,
                                               DataControlFieldCell cell,
                                               DataControlRowState rowState,
                                               bool includeReadOnly)
    {

      // Determine whether the cell contains a RadioButton 
      // in its Controls collection.
      if (cell.Controls.Count > 0) {
        RadioButton radio = cell.Controls[0] as RadioButton;

        object checkedValue = null;
        if (null == radio) {
          // A RadioButton is expected, but a null is encountered.
          // Add error handling.
          throw new InvalidOperationException
              ("RadioButtonField could not extract control.");
        }
        else {
            checkedValue = radio.Checked;
        }


        // Add the value of the Checked attribute of the
        // RadioButton to the dictionary.
        if (dictionary.Contains(DataField))
          dictionary[DataField] = checkedValue;
        else
          dictionary.Add(DataField, checkedValue);
      }
    }
    // This method adds a RadioButton control and any other 
    // content to the cell's Controls collection.
    protected override void InitializeDataCell
        (DataControlFieldCell cell, DataControlRowState rowState) {

      RadioButton radio = new RadioButton();

      // If the RadioButton is bound to a DataField, add
      // the OnDataBindingField method event handler to the
      // DataBinding event.
      if (DataField.Length != 0) {
        radio.DataBinding += new EventHandler(this.OnDataBindField);
      }

      radio.Text = this.Text;

      // Because the RadioButtonField is a BoundField, it only
      // displays data. Therefore, unless the row is in edit mode,
      // the RadioButton is displayed as disabled.
      radio.Enabled = false;
      // If the row is in edit mode, enable the button.
      if ((rowState & DataControlRowState.Edit) != 0 ||
          (rowState & DataControlRowState.Insert) != 0) {
        radio.Enabled = true;
      }

      cell.Controls.Add(radio);
    }
  }
}

O exemplo de código a seguir demonstra como usar o RadioButtonField classe, que é fornecido no exemplo anterior, em um GridView controle. Neste exemplo, o GridView controle exibe dados de uma equipe esportiva. Os dados do player são mantidos em uma tabela de dados que inclui uma coluna de identificação, colunas para os nomes dos jogadores e uma coluna de verdadeira ou falsa que identifica o chefe da equipe. O RadioButtonField classe é usada para exibir o membro da equipe é o atual chefe da equipe. O GridView controle pode ser editado para escolher um novo chefe da equipe ou alterar outras informações do player.

<%@ page language="C#" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.CS"
             Assembly="Samples.AspNet.CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:gridview
          id="GridView1"
          runat="server"
          allowpaging="True"
          datasourceid="SqlDataSource1"
          allowsorting="True"
          autogeneratecolumns="False"
          autogenerateeditbutton="True"
          datakeynames="AnID">
            <columns>

                <aspSample:radiobuttonfield
                  headertext="RadioButtonField"
                  text="TeamLeader"
                  datafield="TrueFalse">
                </aspSample:radiobuttonfield>

                <asp:boundfield
                  insertvisible="False"
                  sortexpression="AnID"
                  datafield="AnID"
                  readonly="True"
                  headertext="AnID">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="FirstName"
                  datafield="FirstName"
                  headertext="FirstName">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="LastName"
                  datafield="LastName"
                  headertext="LastName">
                </asp:boundfield>

              </columns>
        </asp:gridview>
        <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT AnID,FirstName,LastName,TeamLeader FROM Players"
          updatecommand="UPDATE Players SET TrueFalse='false';UPDATE Players SET TrueFalse='true' WHERE AnID=@anID">
        </asp:sqldatasource>

    </form>
</body>
</html>

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: