TreeNodeBinding.FormatString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la cadena que especifica el formato de presentación del texto de un nodo en el que se aplica el objeto 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

Valor de propiedad

String

Cadena de formato que especifica el formato de presentación del texto de un nodo en el que se aplica el objeto TreeNodeBinding. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido la propiedad FormatString.

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la FormatString propiedad para especificar un formato de presentación personalizado para el texto que se muestra en el nodo raíz. En el segundo ejemplo de código se proporcionan datos XML de ejemplo para el primer ejemplo de código.

En el ejemplo de código siguiente se muestra cómo usar la FormatString propiedad para especificar un formato de presentación personalizado para el texto que se muestra en el nodo raíz. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado Book.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>

El ejemplo de código siguiente es datos XML de ejemplo para el ejemplo anterior.

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

Comentarios

La FormatString propiedad se usa para proporcionar un formato personalizado para el texto de un nodo. La cadena de formato de datos consta de dos partes, separadas por dos puntos, con el formato { A : Bxx }. Por ejemplo, la cadena {0:F2} de formato muestra un número de punto fijo con dos posiciones decimales.

Nota

Toda la cadena debe ir entre llaves para indicar que es una cadena de formato y no una cadena literal. Cualquier texto fuera de las llaves se muestra como texto literal.

El valor anterior a los dos puntos (A en el ejemplo general) especifica el índice de parámetros en una lista de parámetros de base cero.

Nota

Este valor solo se puede establecer en 0 porque solo hay un valor en cada nodo.

El carácter después de los dos puntos (B en el ejemplo general) especifica el formato de presentación del valor. En la tabla siguiente se enumeran los formatos comunes.

Formato de carácter Muestra valores numéricos en
C Formato de moneda.
D Formato decimal.
E Formato científico (exponencial).
F Formato fijo.
G Formato general.
N Formato de número.
X Formato hexadecimal.

Nota

Excepto para X, el carácter de formato no distingue mayúsculas de minúsculas. El X carácter de formato muestra los caracteres hexadecimales en el caso especificado.

El valor después del carácter de formato (xx en el ejemplo general) especifica el número de dígitos significativos o posiciones decimales que se van a mostrar.

Para obtener más información sobre cómo dar formato a las cadenas, vea Tipos de formato.

El valor de esta propiedad se almacena en estado de vista.

El valor de la FormatString propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, consulte LocalizableAttributeGlobalización y localización.

Se aplica a

Consulte también