다음을 통해 공유

TreeNodeBinding.FormatString 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

TreeNodeBinding 개체가 적용되는 노드 텍스트의 표시 형식을 지정하는 문자열을 가져오거나 설정합니다.

public:
 property System::String ^ FormatString { System::String ^ get(); void set(System::String ^ value); };
public string FormatString { get; set; }
member this.FormatString : string with get, set
Public Property FormatString As String

속성 값

String

TreeNodeBinding 개체가 적용되는 노드 텍스트의 표시 형식을 지정하는 서식 지정 문자열입니다. 기본값은 빈 문자열("")로, FormatString 속성이 설정되지 않았음을 나타냅니다.

예제

이 섹션에는 두 코드 예제가 있습니다. 첫 번째 코드 예제를 사용 하는 방법에 설명 합니다 FormatString 루트 노드에 표시 되는 텍스트에 대 한 사용자 지정 표시 형식을 지정 하는 속성입니다. 두 번째 코드 예제에서는 첫 번째 코드 예제에 대 한 샘플 XML 데이터를 제공합니다.

다음 코드 예제를 사용 하는 방법에 설명 합니다 FormatString 루트 노드에 표시 되는 텍스트에 대 한 사용자 지정 표시 형식을 지정 하는 속성입니다. 이 예제가 제대로 작동 하려면에 대 한 Book.xml 라는 파일에이 코드 예제에서는 뒤에 제공 된 샘플 XML 데이터를 복사 해야 합니다.


<%@ 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>TreeNodeBinding FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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>TreeNodeBinding FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     --> 
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

다음 코드 예제는 앞의 예제에 대 한 샘플 XML 데이터입니다.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

설명

FormatString 속성 노드의 텍스트에 대 한 사용자 지정 형식을 제공 하는 데 사용 됩니다. 데이터 형식 문자열 형태로 콜론으로 구분 된 두 부분으로 구성 됩니다 { A : Bxx }. 예를 들어 서식 문자열이 {0:F2} 두 소수 자릿수를 사용 하 여 고정 소수점 숫자를 표시 합니다.

참고

전체 문자열 서식 문자열 및 리터럴 문자열이 아닌 것을 나타내기 위해 괄호로 묶어야 합니다. 괄호 밖에 텍스트는 리터럴 텍스트로 표시 됩니다.

콜론 앞 값 (A 예:에서) 매개 변수 인덱스가 0부터 시작 하는 매개 변수 목록을 지정 합니다.

참고

각 노드의 값을 하나만 있기 때문에이 값을 0에만 설정할 수 있습니다.

콜론 문자 (B 예:에서) 값에 대 한 표시 형식을 지정 합니다. 다음 표에서 일반 형식을 나열합니다.

형식 문자 숫자 값 표시
C 통화 형식입니다.
D 10 진수 형식입니다.
E 과학적 (지 수) 형식입니다.
F 고정 된 형식입니다.
G 일반 형식입니다.
N 숫자 형식입니다.
X 16 진수 형식입니다.

참고

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

형식 문자 뒤의 값 (xx 예:에서) 유효 자릿수 또는 소수 자릿수의 수를 지정 합니다.

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

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

값을 FormatString 속성으로 설정 된 경우 디자이너 도구를 사용 하 여 리소스 파일에 자동으로 저장 될 수 있습니다. 자세한 내용은 LocalizableAttribute 하 고 전역화 및 지역화합니다.

적용 대상

추가 정보