ButtonField.DataTextFormatString 속성

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

필드 값의 표시 형식을 지정하는 문자열을 가져오거나 설정합니다.

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

속성 값

String

필드 값의 표시 형식을 지정하는 서식 문자열입니다. 기본값은 빈 문자열("")로, 필드 값에 특정 형식이 적용되지 않음을 나타냅니다.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 DataTextFormatString 필드의 값에 대 한 사용자 지정 표시 형식을 지정 하는 속성입니다.


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

설명

사용 합니다 DataTextFormatString 속성에 표시 되는 값에 대 한 사용자 지정 표시 형식을 지정 하는 ButtonField 개체입니다. 경우는 DataTextFormatString 속성이 설정 되지 않은, 특별 한 서식 없이 필드 값이 표시 됩니다.

참고

형식 문자열이 적용 되 경우에만 DataTextField 속성을 설정 합니다.

형식 문자열 리터럴 문자열일 수 있습니다 및 일반적으로 필드의 값에 대 한 자리 표시자를 포함 합니다. 형식 문자열의 예를 들어 "Item Value: {0}"는 {0} 자리 표시자에 표시 되는 필드에 대 한 값으로 대체 됩니다는 ButtonField 개체입니다. 형식 문자열의 나머지 부분 리터럴 텍스트로 표시 됩니다.

참고

형식 문자열에 자리 표시 자가 포함 되어 있지 않으면, 데이터 원본에서 필드의 값은 최종 표시 텍스트에 포함 되지 않습니다.

콜론으로 구분 하 고 중괄호를 형식에서에 래핑된 두 부분으로 이루어져 있습니다 자리 표시자 { A : Bxx }. 콜론 앞 값 (A 예:에서) 필드 값의 인덱스 0부터 시작 하는 매개 변수 목록을 지정 합니다.

참고

이 A 매개 변수는 서식 구문의 일부입니다. 각 셀에서 필드를 하나만 값 이기 때문에이 값을 0으로 설정할 수만 있습니다.

콜론 및 콜론 뒤의 값은 선택적입니다. 콜론 문자 (B 예:에서) 값을 표시 하는 형식을 지정 합니다. 다음 표에서 일반 형식을 나열합니다.

형식 문자	Description
`C`	통화 형식으로 숫자 값을 표시합니다.
`D`	10 진수 형식의 숫자 값을 표시합니다.
`E`	과학적 (지 수)의 숫자 값을 표시합니다.
`F`	고정 형식으로 숫자 값을 표시합니다.
`G`	숫자 값을 표시 일반적 서식을 지정합니다.
`N`	숫자 형식의 숫자 값을 표시합니다.
`X`	16 진수 형식의 숫자 값을 표시합니다.

참고

제외 하 고 X에 형식 문자는 대/소문자 구분 되지 않습니다. X 형식 문자를 지정한 경우 16 진수 문자를 표시 합니다.

형식 문자 뒤의 값 (xx 예:에서) 유효 자릿수 또는 소수 자릿수의 수를 지정 합니다. 예를 들어 형식 문자열 "{0:F2}" 두 소수 자릿수를 사용 하 여 고정 소수점 숫자를 표시 합니다.

문자열 형식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.

이 속성의 값은 뷰 상태에 저장 됩니다.

적용 대상

추가 정보

.NET의 서식 지정 형식

다음을 통해 공유

ButtonField.DataTextFormatString 속성

정의

속성 값

예제

설명

적용 대상

추가 정보

추가 리소스