ButtonField.DataTextFormatString Propriedade

Referência

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.

Obtém ou define a cadeia de caracteres que especifica o formato de exibição do valor do campo.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };

public virtual string DataTextFormatString { get; set; }

member this.DataTextFormatString : string with get, set

Public Overridable Property DataTextFormatString As String

Valor da propriedade

String

Uma cadeia de caracteres de formato que especifica o formato de exibição para o valor do campo. O padrão é uma cadeia de caracteres vazia (""), o que indica que nenhuma formatação especial é aplicada ao valor do campo.

Exemplos

O exemplo de código a seguir demonstra como usar a DataTextFormatString propriedade para especificar um formato de exibição personalizado para os valores de um campo.


<%@ 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">

  void AuthorsGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = AuthorsGridView.Rows[index];
      TableCell lastNameCell = selectedRow.Cells[1];
      string lastName = lastNameCell.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + lastName + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField DataTextField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="AuthorsGridView"/>
                    
      <!-- Set the DataTextField property of the ButtonField -->
      <!-- declaratively. Set the DataTextFormatString       -->
      <!-- property to apply special formatting to the text. -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="AuthorsGridView_RowCommand" 
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Link" 
            commandname="Select"
            headertext="Select Author"
            datatextfield="au_lname"
            datatextformatstring="[{0}]"    
            text="Select"/>
          <asp:boundfield datafield="au_fname" 
            headertext="First Name"/>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        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">
<script runat="server">

  Sub AuthorsGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
    ' If multiple ButtonField column fields are used, use the
    ' CommandName property to determine which button was clicked.
    If e.CommandName = "Select" Then
    
      ' Convert the row index stored in the CommandArgument
      ' property to an Integer.
      Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
      ' Get the last name of the selected author from the appropriate
      ' cell in the GridView control.
      Dim selectedRow As GridViewRow = AuthorsGridView.Rows(index)
      Dim lastNameCell As TableCell = selectedRow.Cells(1)
      Dim lastName As String = lastNameCell.Text
    
      ' Display the selected author.
      Message.Text = "You selected " & lastName & "."
      
    End If
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField DataTextField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="AuthorsGridView"/>
                    
      <!-- Set the DataTextField property of the ButtonField -->
      <!-- declaratively. Set the DataTextFormatString       -->
      <!-- property to apply special formatting to the text. -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="AuthorsGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Link" 
            commandname="Select"
            headertext="Select Author"
            datatextfield="au_lname"
            datatextformatstring="[{0}]"    
            text="Select"/>
          <asp:boundfield datafield="au_fname" 
            headertext="First Name"/>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentários

Use a DataTextFormatString propriedade para especificar um formato de exibição personalizado para os valores exibidos no ButtonField objeto. Se a DataTextFormatString propriedade não estiver definida, o valor do campo será exibido sem nenhuma formatação especial.

Observação

A cadeia de caracteres de formato é aplicada somente quando a DataTextField propriedade é definida.

A cadeia de caracteres de formato pode ser qualquer cadeia de caracteres literal e geralmente inclui um espaço reservado para o valor do campo. Por exemplo, na cadeia de "Item Value: {0}"caracteres de formato, o {0} espaço reservado é substituído pelo valor do campo quando ele é exibido no ButtonField objeto. O restante da cadeia de caracteres de formato é exibido como texto literal.

Observação

Se a cadeia de caracteres de formato não incluir um espaço reservado, o valor do campo da fonte de dados não será incluído no texto de exibição final.

O espaço reservado consiste em duas partes, separadas por dois-pontos e encapsuladas em chaves, na forma { A : Bxx }. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo em uma lista de parâmetros baseada em zero.

Observação

Esse A parâmetro faz parte da sintaxe de formatação. Como há apenas um valor de campo em cada célula, esse valor só pode ser definido como 0.

Os dois-pontos e os valores após os dois-pontos são opcionais. O caractere após o dois-pontos (B no exemplo geral) especifica o formato no qual exibir o valor. A tabela a seguir lista os formatos comuns.

Formatar caractere	Descrição
`C`	Exibe valores numéricos no formato de moeda.
`D`	Exibe valores numéricos no formato decimal.
`E`	Exibe valores numéricos no formato científico (exponencial).
`F`	Exibe valores numéricos em formato fixo.
`G`	Exibe valores numéricos em formato geral.
`N`	Exibe valores numéricos no formato numérico.
`X`	Exibe valores numéricos no formato hexadecimal.

Observação

Exceto por X, os caracteres de formato não diferenciam maiúsculas de minúsculas. O X caractere de formato exibe os caracteres hexadecimal no caso especificado.

O valor após o caractere de formato (xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidas. Por exemplo, a cadeia "{0:F2}" de caracteres de formato exibe um número de ponto fixo com duas casas decimais.

Para mais informações sobre cadeias de caracteres de formatação, consulte Tipos de formatação.

O valor dessa propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também

Tipos de formatação no .NET

Compartilhar via

ButtonField.DataTextFormatString Propriedade

Definição

Valor da propriedade

Exemplos

Comentários

Aplica-se a

Confira também

Recursos adicionais