ButtonField.DataTextFormatString Tulajdonság

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Lekéri vagy beállítja a mező értékének megjelenítési formátumát meghatározó sztringet.

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

Tulajdonság értéke

String

A mező értékének megjelenítési formátumát meghatározó formázási sztring. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy a mezőértékre nincs speciális formázás alkalmazva.

Példák

Az alábbi példakód bemutatja, hogyan használható a DataTextFormatString tulajdonság egy mező értékeinek egyéni megjelenítési formátumának megadására.


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

Megjegyzések

DataTextFormatString A tulajdonság használatával egyéni megjelenítési formátumot adhat meg az objektumban ButtonField megjelenített értékekhez. Ha a DataTextFormatString tulajdonság nincs beállítva, a mező értéke speciális formázás nélkül jelenik meg.

Note

A formátumsztring csak akkor lesz alkalmazva, ha a DataTextField tulajdonság be van állítva.

A formátumsztring bármilyen literális sztring lehet, és általában tartalmaz egy helyőrzőt a mező értékéhez. A formátumsztringben "Item Value: {0}"például a {0} helyőrzőt lecseréli a mező értékére, amikor az megjelenik az ButtonField objektumban. A formátumsztring többi része konstans szövegként jelenik meg.

Note

Ha a formátumsztring nem tartalmaz helyőrzőt, az adatforrásból származó mező értéke nem szerepel a végleges megjelenítési szövegben.

A helyőrző két részből áll, kettősponttal elválasztva és kapcsos zárójelekbe burkolva{ A : Bxx }. A kettőspont előtti érték (A az általános példában) a mezőérték indexét adja meg a paraméterek nullaalapú listájában.

Note

Ez A a paraméter a formázási szintaxis része. Mivel minden cellában csak egy mezőérték található, ez az érték csak 0 értékre állítható be.

A kettőspont és a kettőspont utáni értékek megadása nem kötelező. A kettőspont utáni karakter (B az általános példában) azt a formátumot adja meg, amelyben az értéket meg szeretné jeleníteni. Az alábbi táblázat a gyakori formátumokat sorolja fel.

Karakter formázása	Leírás
`C`	Numerikus értékeket jelenít meg pénznem formátumban.
`D`	Numerikus értékeket jelenít meg decimális formátumban.
`E`	Numerikus értékeket jelenít meg tudományos (exponenciális) formátumban.
`F`	Numerikus értékeket jelenít meg rögzített formátumban.
`G`	Numerikus értékeket jelenít meg általános formátumban.
`N`	Numerikus értékeket jelenít meg számformátumban.
`X`	Numerikus értékeket jelenít meg hexadecimális formátumban.

Note

A formátumkarakterek a Xkis- és nagybetűk kivételével nem megkülönböztetik a kis- és nagybetűket. A X formátumkarakterek a megadott esetben a hexadecimális karaktereket jelenítik meg.

A formátum karakter utáni érték (xx az általános példában) a megjelenítendő jelentős számjegyek vagy tizedesjegyek számát határozza meg. A formátumsztring "{0:F2}" például két tizedesjegyet tartalmazó rögzített pontszámot jelenít meg.

A sztringek formázásáról további információt a Formázási típusok című témakörben talál.

Ennek a tulajdonságnak az értéke megtekintési állapotban van tárolva.

A következőre érvényes:

Lásd még

Formatting Types in .NET

Visszajelzés

Hasznosnak találta ezt az oldalt?