ButtonField.DataTextFormatString Propriedade

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém ou define a cadeia que especifica o formato de exibição para o 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 de Propriedade

String

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

Exemplos

O exemplo de código seguinte demonstra como usar a DataTextFormatString propriedade para especificar um formato de visualizaçã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>

Observações

Use a DataTextFormatString propriedade para especificar um formato de exibição personalizado para os valores que são apresentados no ButtonField objeto. Se a DataTextFormatString propriedade não estiver definida, o valor do campo é apresentado sem qualquer formatação especial.

Note

A string de formato é aplicada apenas quando a DataTextField propriedade está definida.

A cadeia de formato pode ser qualquer cadeia literal e normalmente inclui um marcador para o valor do campo. Por exemplo, na string "Item Value: {0}"de formato , o {0} marcador é substituído pelo valor do campo quando é apresentado no ButtonField objeto. O resto da cadeia de formatos é apresentado como texto literal.

Note

Se a cadeia de formato não incluir um marcador de posição, o valor do campo da fonte de dados não é incluído no texto final de visualização.

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

Note

Este A parâmetro faz parte da sintaxe de formatação. Como existe apenas um valor de campo em cada célula, este valor só pode ser definido para 0.

O dois-pontos e os valores após o dois-pontos são opcionais. O carácter após os dois-pontos (B no exemplo geral) especifica o formato em que o valor deve ser exibido. A tabela seguinte lista os formatos comuns.

Carácter de formato	Description
`C`	Apresenta valores numéricos em formato de moeda.
`D`	Apresenta valores numéricos em formato decimal.
`E`	Apresenta valores numéricos em formato científico (exponencial).
`F`	Apresenta valores numéricos em formato fixo.
`G`	Apresenta valores numéricos em formato geral.
`N`	Apresenta valores numéricos em formato numérico.
`X`	Apresenta valores numéricos em formato hexadecimal.

Note

Exceto por X, os caracteres de formato não são diferenciados em maiúsculas minúsculas. O X carácter de formato apresenta os caracteres hexadecimais no caso especificado.

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

Para mais informações sobre strings de formatação, consulte Tipos de Formatação.

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também

Tipos de Formatação em .NET

Comentários

Esta página foi útil?