Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

CommandField Classe

Representa um campo especial que exibe botões de comando para executar selecionando, editando, inserir ou excluir operações em um Controlarar ligado a dados.

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

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class CommandField : ButtonFieldBase

The CommandField class is a special field used by data-bound controls (such as GridView and DetailsView) to display command buttons that perform delete, edit, insert, or select operations.Os botões de comando para executar essas operações podem ser mostradas ou Oculto usando as propriedades mostradas a seguinte tabela.

Propriedade

Descrição

ShowDeleteButton

Shows or hides a Delete button in a CommandField field for each record in the data-bound control.O botão Excluir permite que o usuário para excluir um registro a partir de Fonte de Dados.

ShowEditButton

Shows or hides an Edit button in a CommandField field for each record in the data-bound control.O botão Editar permite que o usuário para editar um registro a partir de Fonte de Dados.Quando o usuário clica no botão Editar para um registro específico, que editar botão é substituído com um botão de atualização e um botão ' Cancelar '.Todos os outros botões de comando são também Oculto.

ShowInsertButton

Shows or hides the New button in a CommandField field.O novo botão permite que o usuário para inserir um novo registro na Fonte de Dados.Quando o usuário clica no botão Novo, ele será substituído com um botão Inserir e um botão ' Cancelar '.Todos os outros botões de comando são também Oculto.

Observação:

This property applies only to data-bound controls that support inserting operations, such as the DetailsView control.

ShowSelectButton

Shows or hides a Select button in a CommandField field for each record in the data-bound control.O botão Selecionar permite que o usuário selecione um registro no Controlarar ligado a dados.

In addition, the Cancel button displayed when a record is in edit or insert mode can be shown or hidden by setting the ShowCancelButton property.

Observação:

When a data-bound control is used in combination with a data source control (such as a SqlDataSource control), the data-bound control can take advantage of the data source control's capabilities and provide automatic delete, update, and insert functionality.Para outras fontes de dados, você precisará fornecer as rotinas para executar essas operações durante os eventos apropriados para o Controlarar ligado a dados.

The CommandField field is displayed differently depending on the data-bound control in which it is used.For example, the GridView control displays a CommandField field as a column, while the DetailsView control displays it as a row.

To specify the type of button to display, use the ButtonType property.When the ButtonType property is set to ButtonType.Button or ButtonType.Link, you can specify the text to display for the buttons by setting the properties shown in the following table.

Propriedade

Descrição

CancelText

A legenda do botão ' Cancelar '.

DeleteText

A legenda para o botão ' excluir '.

EditText

A legenda do botão Editar.

InsertText

A legenda do botão Inserir.

Observação:

This property applies only to data-bound controls that support insert operations, such as the DetailsView control.

NewText

A legenda do botão Novo.

Observação:

This property applies only to data-bound controls that support insert operations, such as the DetailsView control.

SelectText

A legenda do botão Selecionar.

UpdateText

A legenda do botão de atualização.

Instead of displaying a command button or a link button, you can display an image button by setting the ButtonType property to ButtonType.Image and then setting the properties shown in the following table.

Propriedade

Descrição

CancelImageUrl

A imagem para Exibir para o botão Cancelar

DeleteImageUrl

A imagem para Exibir para o botão Excluir.

EditImageUrl

A imagem para Exibir para o botão Editar.

InsertText

A imagem para Exibir para o botão Inserção.

Observação:

This property applies only to data-bound controls that support insert operations, such as the DetailsView control.

NewImageUrl

A imagem para Exibir para o novo botão.

Observação:

This property applies only to data-bound controls that support insert operations, such as the DetailsView control.

SelectImageUrl

A imagem para Exibir para o botão Selecionar.

UpdateImageUrl

A imagem para Exibir para o botão Atualizar.

By default, when the user clicks a button in a CommandField field, validation is performed on all validation controls on the page.To prevent validation from occurring when a button is clicked, set the CausesValidation property to false.

You can hide a CommandField field in a data-bound control by setting the Visible property to false.

The CommandField field allows you to customize its header and footer sections.To display a caption in the header or the footer section, set the HeaderText or the FooterText property, respectively.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property.To hide the header section in a CommandField object, set the ShowHeader property to false.

Observação:

Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control.These data-bound controls do not support the ShowHeader property for an individual button field.To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

You also can customize the appearance of the CommandField object (font color, background color, and so on) by setting the style properties for the different parts of the field.A tabela a seguir lista as propriedades de estilo diferente.

Propriedade de estilo

Descrição

ControlStyle

The style settings for the child Web server controls of the CommandField object.

FooterStyle

The style settings for the footer section of the CommandField object.

HeaderStyle

The style settings for the header section of the CommandField object.

ItemStyle

The style settings for the data items in the CommandField object.

The following code example demonstrates how to use a CommandField field to display controls to edit a record in a GridView control.


<%@ Page language= %>

<!DOCTYPE html PUBLIC "-
    "http:
<html xmlns="http:
  <head runat=>
    <title>CommandField Example</title>
</head>
<body>
    <form id= runat=>

      <h3>CommandField Example</h3>

      <asp:gridview id= 
        datasourceid= 
        autogeneratecolumns=
        datakeynames=  
        runat=>

        <columns>
          <asp:commandfield showeditbutton=
            headertext=/>
          <asp:boundfield datafield=
            headertext= />
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
        </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   -->
      <!--  the Web.config file.                            -->
      <asp:sqldatasource id=  
        selectcommand=
        updatecommand=
        connectionstring=
        runat=>
      </asp:sqldatasource>

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



The following code example demonstrates how to use the CancelText, EditText, and UpdateText properties to customize the text for the editing controls.


<%@ Page language= %>

<!DOCTYPE html PUBLIC "-
    "http:
<html xmlns="http:
  <head runat=>
    <title>CommandField Example</title>
</head>
<body>
    <form id= runat=>

      <h3>CommandField Example</h3>

      <asp:gridview id= 
        datasourceid= 
        autogeneratecolumns=
        datakeynames=  
        runat=>

        <columns>
          <asp:commandfield showeditbutton=
            edittext=
            canceltext=
            updatetext=
            headertext=/>
          <asp:boundfield datafield=
            headertext= />
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
          <asp:boundfield datafield=
            headertext=/>
        </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   -->
      <!--  the Web.config file.                            -->
      <asp:sqldatasource id=  
        selectcommand=
        updatecommand=
        connectionstring=
        runat=>
      </asp:sqldatasource>

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



Quaisquer membros públicos estático (compartilhados na Visual Basic) desse tipo são Thread seguro. Não há garantia de que qualquer membro de instância seja isento de segmentos.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft