ButtonField.DataTextFormatString Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt de tekenreeks opgehaald of ingesteld waarmee de weergave-indeling voor de waarde van het veld wordt opgegeven.

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

Waarde van eigenschap

String

Een notatietekenreeks die de weergavenotatie voor de waarde van het veld aangeeft. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat er geen speciale opmaak wordt toegepast op de veldwaarde.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de DataTextFormatString eigenschap gebruikt om een aangepaste weergave-indeling op te geven voor de waarden van een veld.


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

Opmerkingen

Gebruik de DataTextFormatString eigenschap om een aangepaste weergave-indeling op te geven voor de waarden die in het ButtonField object worden weergegeven. Als de DataTextFormatString eigenschap niet is ingesteld, wordt de waarde voor het veld weergegeven zonder speciale opmaak.

Note

De notatietekenreeks wordt alleen toegepast wanneer de DataTextField eigenschap is ingesteld.

De notatietekenreeks kan elke letterlijke tekenreeks zijn en bevat meestal een tijdelijke aanduiding voor de waarde voor het veld. In de notatietekenreeks "Item Value: {0}"wordt de {0} tijdelijke aanduiding bijvoorbeeld vervangen door de waarde voor het veld wanneer deze wordt weergegeven in het ButtonField object. De rest van de notatietekenreeks wordt weergegeven als letterlijke tekst.

Note

Als de notatietekenreeks geen tijdelijke aanduiding bevat, wordt de waarde voor het veld uit de gegevensbron niet opgenomen in de uiteindelijke weergavetekst.

De tijdelijke aanduiding bestaat uit twee delen, gescheiden door een dubbele punt en verpakt in accolades, in de vorm { A : Bxx }. De waarde vóór de dubbele punt (A in het algemene voorbeeld) geeft de index voor de veldwaarde op in een op nul gebaseerde lijst met parameters.

Note

Deze A parameter maakt deel uit van de syntaxis van de opmaak. Omdat er slechts één veldwaarde in elke cel is, kan deze waarde alleen worden ingesteld op 0.

De dubbele punt en de waarden na de dubbele punt zijn optioneel. Het teken na de dubbele punt (B in het algemene voorbeeld) geeft de notatie op waarin de waarde moet worden weergegeven. De volgende tabel bevat de algemene notaties.

Teken opmaken Beschrijving
C Geeft numerieke waarden weer in valutanotatie.
D Geeft numerieke waarden weer in decimale notatie.
E Geeft numerieke waarden weer in wetenschappelijke (exponentiële) notatie.
F Geeft numerieke waarden weer in vaste notatie.
G Geeft numerieke waarden weer in de algemene notatie.
N Geeft numerieke waarden weer in getalnotatie.
X Geeft numerieke waarden weer in hexadecimale notatie.

Note

XBehalve, de notatietekens zijn niet hoofdlettergevoelig. In X het notatieteken worden de hexadecimale tekens weergegeven in het geval dat is opgegeven.

De waarde na het notatieteken (xx in het algemene voorbeeld) geeft het aantal significante cijfers of decimalen op dat moet worden weergegeven. De notatietekenreeks "{0:F2}" geeft bijvoorbeeld een vast puntnummer weer met twee decimalen.

Zie Opmaaktypen voor meer informatie over het opmaken van tekenreeksen.

De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.

Van toepassing op

Zie ook