BindingBase.StringFormat Propiedad

Definición

Espacio de nombres:

System.Windows.Data

Ensamblado:

PresentationFramework.dll

Obtiene o establece una cadena que especifica cómo dar formato al enlace si muestra el valor enlazado como una cadena.

public:
 property System::String ^ StringFormat { System::String ^ get(); void set(System::String ^ value); };

public string StringFormat { get; set; }

member this.StringFormat : string with get, set

Public Property StringFormat As String

Valor de propiedad

String

Cadena que especifica cómo dar formato al enlace si muestra el valor enlazado como una cadena.

Ejemplos

En el ejemplo siguiente se usa la StringFormat propiedad para convertir Price, que es , Doubleen una cadena que representa una moneda.

<ListView ItemsSource="{StaticResource MyData}">
  <ListView.View>
    <GridView>
      <GridViewColumn DisplayMemberBinding="{Binding Path=Description}"/>
      <GridViewColumn DisplayMemberBinding="{Binding Path=Price, StringFormat=Now {0:c}!}"/>
    </GridView>
  </ListView.View>
</ListView>

En el ejemplo siguiente se usa la StringFormat propiedad de para MultiBinding crear una cadena que incluya y PriceDescription de cada elemento de un ListBox.

<ListBox ItemsSource="{StaticResource MyData}">

  <ListBox.ItemTemplate>
    <DataTemplate>
      <TextBlock>
        <TextBlock.Text>
          <MultiBinding  StringFormat="{}{0} -- Now only {1:C}!">
            <Binding Path="Description"/>
            <Binding Path="Price"/>
          </MultiBinding>
        </TextBlock.Text>
      </TextBlock>
    </DataTemplate>
  </ListBox.ItemTemplate>
</ListBox>

Comentarios

StringFormat puede ser un formato de cadena predefinido, compuesto o personalizado. Para obtener más información sobre los formatos de cadena, vea Tipos de formato.

Si establece las Converter propiedades y StringFormat , el convertidor se aplica primero al valor de datos y, a continuación, se aplica .StringFormat

Cuando se establece en StringFormat en un Binding formato de cadena compuesta, solo se puede especificar un parámetro.

Cuando se usa , MultiBindingla StringFormat propiedad solo se aplica cuando se establece en .MultiBinding El valor de StringFormat que se establece en cualquier objeto secundario Binding se omite. El número de parámetros de un formato de cadena compuesta no puede superar el número de objetos secundarios Binding en MultiBinding.

Cuando se usa , PriorityBindingpuede establecer en StringFormatPriorityBinding, en objetos de enlace secundarios o ambos. StringFormat Si se establece en el enlace secundario que se aplica, se usa ese valor. StringFormat Si no se establece en el enlace secundario que se aplica, el StringFormat de PriorityBinding se aplica si se establece.

Si la cadena de formato comienza con el { carácter , el analizador XAML lo confundirá para una extensión de marcado. Para evitar esta ambigüedad, prefijo la cadena de formato con un conjunto vacío de llaves.