CommandField Classe

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um campo especial que exibe botões de comando para executar operações de seleção, edição, inserção ou exclusão em um controle associado a dados.

public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase

public class CommandField : System.Web.UI.WebControls.ButtonFieldBase

type CommandField = class
    inherit ButtonFieldBase

Public Class CommandField
Inherits ButtonFieldBase

Herança: Object

DataControlField

ButtonFieldBase
CommandField

Exemplos

O exemplo de código a seguir demonstra como usar um CommandField campo para exibir controles para editar um registro em um GridView controle.


<%@ 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

O exemplo de código a seguir demonstra como usar o CancelText, EditTexte UpdateText as propriedades para personalizar o texto para os controles de edição.


<%@ 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentários

A CommandField classe é um campo especial usado por controles associados a dados (como GridView e DetailsView) para exibir botões de comando que executam operações de exclusão, edição, inserção ou seleção. Os botões de comando para executar essas operações podem ser mostrados ou ocultos usando as propriedades mostradas na tabela a seguir.

Propriedade	Descrição
ShowDeleteButton	Mostra ou oculta um botão Excluir em um CommandField campo para cada registro no controle associado a dados. O botão Excluir permite que o usuário exclua um registro da fonte de dados.
ShowEditButton	Mostra ou oculta um botão Editar em um CommandField campo para cada registro no controle associado a dados. O botão Editar permite que o usuário edite um registro da fonte de dados. Quando o usuário clica no botão Editar para um registro específico, esse botão Editar é substituído por um botão Atualizar e um botão Cancelar. Todos os outros botões de comando também estão ocultos.
ShowInsertButton	Mostra ou oculta o botão Novo em um CommandField campo. O botão Novo permite que o usuário insira um novo registro na fonte de dados. Quando o usuário clica no botão Novo, ele é substituído por um botão Inserir e um botão Cancelar. Todos os outros botões de comando também estão ocultos. Nota: Essa propriedade se aplica somente a controles associados a dados que dão suporte à inserção de operações, como o DetailsView controle.
ShowSelectButton	Mostra ou oculta um botão Selecionar em um CommandField campo para cada registro no controle associado a dados. O botão Selecionar permite que o usuário selecione um registro no controle associado a dados.

Além disso, o botão Cancelar exibido quando um registro está no modo de edição ou inserção pode ser mostrado ou oculto definindo a ShowCancelButton propriedade.

Observação

Quando um controle associado a dados é usado em combinação com um controle de fonte de dados (como um SqlDataSource controle), o controle associado a dados pode tirar proveito dos recursos do controle da fonte de dados e fornecer a funcionalidade de exclusão, atualização e inserção automáticas. Para outras fontes de dados, você precisa fornecer as rotinas para executar essas operações durante os eventos apropriados para o controle associado a dados.

O CommandField campo é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um CommandField campo como uma coluna, enquanto o controle o DetailsView exibe como uma linha.

Para especificar o tipo de botão a ser exibido, use a ButtonType propriedade. Quando a ButtonType propriedade é definida ButtonType.Button como ou ButtonType.Link, você pode especificar o texto a ser exibido para os botões definindo as propriedades mostradas na tabela a seguir.

Propriedade	Descrição
CancelText	A legenda do botão Cancelar.
DeleteText	A legenda do botão Excluir.
EditText	A legenda do botão Editar.
InsertText	A legenda do botão Inserir. Nota: Essa propriedade se aplica somente a controles associados a dados que dão suporte a operações de inserção, como o DetailsView controle.
NewText	A legenda do botão Novo. Nota: Essa propriedade se aplica somente a controles associados a dados que dão suporte a operações de inserção, como o DetailsView controle.
SelectText	A legenda do botão Selecionar.
UpdateText	A legenda do botão Atualizar.

Em vez de exibir um botão de comando ou um botão de link, você pode exibir um botão de imagem definindo a ButtonType propriedade ButtonType.Image e definindo as propriedades mostradas na tabela a seguir.

Propriedade	Descrição
CancelImageUrl	A imagem a ser exibida para o botão Cancelar
DeleteImageUrl	A imagem a ser exibida para o botão Excluir.
EditImageUrl	A imagem a ser exibida para o botão Editar.
InsertText	A imagem a ser exibida para o botão Inserir. Nota: Essa propriedade se aplica somente a controles associados a dados que dão suporte a operações de inserção, como o DetailsView controle.
NewImageUrl	A imagem a ser exibida para o botão Novo. Nota: Essa propriedade se aplica somente a controles associados a dados que dão suporte a operações de inserção, como o DetailsView controle.
SelectImageUrl	A imagem a ser exibida para o botão Selecionar.
UpdateImageUrl	A imagem a ser exibida para o botão Atualizar.

Por padrão, quando o usuário clica em um botão em um CommandField campo, a validação é executada em todos os controles de validação na página. Para impedir que a validação ocorra quando um botão é clicado, defina a CausesValidation propriedade como false.

Você pode ocultar um CommandField campo em um controle associado a dados definindo a Visible propriedade como false.

O CommandField campo permite personalizar suas seções de cabeçalho e rodapé. Para exibir uma legenda na seção cabeçalho ou rodapé, defina a HeaderText propriedade ou a FooterText propriedade, respectivamente. Em vez de exibir o texto na seção de cabeçalho, você pode exibir uma imagem definindo a HeaderImageUrl propriedade. Para ocultar a seção de cabeçalho em um CommandField objeto, defina a ShowHeader propriedade como false.

Observação

Alguns controles associados a dados (como o GridView controle) podem mostrar ou ocultar apenas toda a seção de cabeçalho do controle. Esses controles associados a dados não dão suporte à ShowHeader propriedade para um campo de botão individual. Para mostrar ou ocultar toda a seção de cabeçalho de um controle associado a dados (se disponível), use a propriedade do ShowHeader controle.

Você também pode personalizar a aparência do objeto (cor da CommandField fonte, cor da tela de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo. A tabela a seguir lista as propriedades de estilo diferentes.

Propriedade Style	Descrição
ControlStyle	As configurações de estilo para os controles do servidor Web filho do CommandField objeto.
FooterStyle	As configurações de estilo para a seção rodapé do CommandField objeto.
HeaderStyle	As configurações de estilo para a seção de cabeçalho do CommandField objeto.
ItemStyle	As configurações de estilo para os itens de dados no CommandField objeto.

Construtores

Nome	Description
CommandField()	Inicializa uma nova instância da classe CommandField.

Propriedades

Nome	Description
AccessibleHeaderText	Obtém ou define o texto renderizado como o valor da `AbbreviatedText` propriedade em alguns controles. (Herdado de DataControlField)
ButtonType	Obtém ou define o tipo de botão a ser exibido no campo de botão. (Herdado de ButtonFieldBase)
CancelImageUrl	Obtém ou define a URL para uma imagem a ser exibida para o botão Cancelar em um CommandField campo.
CancelText	Obtém ou define a legenda do botão Cancelar exibido em um CommandField campo.
CausesValidation	Obtém ou define um valor que indica se a validação é executada quando o usuário clica em um botão em um CommandField campo.
Control	Obtém uma referência ao controle de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de todos os controles de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField)
DeleteImageUrl	Obtém ou define a URL como uma imagem a ser exibida para um botão Excluir em um CommandField campo.
DeleteText	Obtém ou define a legenda de um botão Excluir em um CommandField campo.
DesignMode	Obtém um valor que indica se um campo de controle de dados é exibido no momento em um ambiente de tempo de design. (Herdado de DataControlField)
EditImageUrl	Obtém ou define a URL para uma imagem a ser exibida para um botão Editar em um CommandField campo.
EditText	Obtém ou define a legenda de um botão Editar em um CommandField campo.
FooterStyle	Obtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField)
FooterText	Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField)
HeaderImageUrl	Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField)
HeaderStyle	Obtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField)
HeaderText	Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField)
InsertImageUrl	Obtém ou define a URL como uma imagem a ser exibida para o botão Inserir em um CommandField campo.
InsertText	Obtém ou define a legenda do botão Inserir em um CommandField campo.
InsertVisible	Obtém um valor que indica se o DataControlField objeto está visível quando seu controle associado a dados pai está no modo de inserção. (Herdado de DataControlField)
IsTrackingViewState	Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu estado de exibição. (Herdado de DataControlField)
ItemStyle	Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField)
NewImageUrl	Obtém ou define a URL como uma imagem a ser exibida para o botão Novo em um CommandField campo.
NewText	Obtém ou define a legenda do botão Novo em um CommandField campo.
SelectImageUrl	Obtém ou define a URL para uma imagem a ser exibida para um botão Selecionar em um CommandField campo.
SelectText	Obtém ou define a legenda de um botão Selecionar em um CommandField campo.
ShowCancelButton	Obtém ou define um valor que indica se um botão Cancelar é exibido em um CommandField campo.
ShowDeleteButton	Obtém ou define um valor que indica se um botão Excluir é exibido em um CommandField campo.
ShowEditButton	Obtém ou define um valor que indica se um botão Editar é exibido em um CommandField campo.
ShowHeader	Obtém ou define um valor que indica se a seção de cabeçalho é exibida em um ButtonFieldBase objeto. (Herdado de ButtonFieldBase)
ShowInsertButton	Obtém ou define um valor que indica se um botão Novo é exibido em um CommandField campo.
ShowSelectButton	Obtém ou define um valor que indica se um botão Selecionar é exibido em um CommandField campo.
SortExpression	Obtém ou define uma expressão de classificação usada por um controle de fonte de dados para classificar dados. (Herdado de DataControlField)
UpdateImageUrl	Obtém ou define a URL para uma imagem a ser exibida para um botão Atualizar em um CommandField campo.
UpdateText	Obtém ou define a legenda de um botão Atualizar em um CommandField campo.
ValidateRequestMode	Obtém ou define um valor que especifica se o controle valida a entrada do cliente. (Herdado de DataControlField)
ValidationGroup	Obtém ou define o nome do grupo de controles de validação a ser validado quando um botão em um ButtonFieldBase objeto é clicado. (Herdado de ButtonFieldBase)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um DataControlField objeto em várias solicitações para a mesma página. (Herdado de DataControlField)
Visible	Obtém ou define um valor que indica se um campo de controle de dados é renderizado. (Herdado de DataControlField)

Métodos

Nome	Description
CloneField()	Cria uma cópia duplicada do objeto derivado atual DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto atual CommandField para o objeto especificado DataControlField .
CreateField()	Cria um objeto CommandField vazio.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrai o valor do campo de controle de dados da célula da tabela atual e adiciona o valor à coleção especificada IDictionary . (Herdado de DataControlField)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize(Boolean, Control)	Executa a inicialização de instância básica para um campo de controle de dados. (Herdado de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa o objeto especificado DataControlFieldCell para o estado da linha especificado.
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados. (Herdado de DataControlField)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnFieldChanged()	Aciona o evento `FieldChanged`. (Herdado de DataControlField)
SaveViewState()	Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField)
ToString()	Retorna uma cadeia de caracteres que representa esse DataControlField objeto. (Herdado de DataControlField)
TrackViewState()	Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controles contidos em um CommandField objeto dão suporte a retornos de chamada.

Implantações explícitas de interface

Nome	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a esse DataControlField objeto. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu estado de exibição. (Herdado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente do campo de controle de dados. (Herdado de DataControlField)
IStateManager.SaveViewState()	Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField)

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Partilhar via

CommandField Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários