BindingBase.StringFormat Propiedad

Definición

Espacio de nombres:

System.Windows.Data

Ensamblado:

PresentationFramework.dll

Obtiene o establece una cadena que especifica cómo se aplica 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 se aplica 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 propiedad en MultiBinding para crear una cadena que incluya y Price Description de cada elemento de un ListBox.StringFormat

<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 Aplicar formato a tipos.

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 Binding un 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. Se omite el valor de StringFormat que se establece en cualquier objeto secundario Binding . El número de parámetros en un formato de cadena compuesta no puede superar el número de objetos secundarios Binding en .MultiBinding

Cuando se usa , PriorityBindingse puede establecer en StringFormat PriorityBinding, 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, anteponga la cadena de formato con un conjunto vacío de llaves.