HyperLinkField.DataTextFormatString 속성

참조

정의

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

어셈블리:: System.Web.dll

중요

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

HyperLinkField 개체의 하이퍼링크 캡션이 표시되는 형식을 지정하는 문자열을 가져오거나 설정합니다.

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

HyperLinkField의 하이퍼링크 캡션이 표시되는 형식을 지정하는 문자열입니다. 기본값은 빈 문자열("")로, 특수 형식이 하이퍼링크 캡션에 적용되지 않음을 나타냅니다.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 DataTextFormatString 값의 형식을 지정 하는 속성에 표시 되는 하이퍼링크 캡션에 바인딩할를 HyperLinkField 개체입니다. 값의 서식이 통화로 지정 됩니다.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>
                 
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>
                 
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

설명

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

참고

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

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

참고

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

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

참고

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

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

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

참고

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

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

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

적용 대상

다음을 통해 공유

HyperLinkField.DataTextFormatString 속성

정의

속성 값

예제

설명

적용 대상

추가 정보

추가 리소스