BindingBase.StringFormat Propiedad

Definición

Obtiene o establece una cadena que especifica cómo se aplica formato al enlace si muestra el valor enlazado como una cadena.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

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

Cadena que especifica cómo se aplica formato al enlace si muestra el valor enlazado como una cadena.A string that specifies how to format the binding if it displays the bound value as a string.

Ejemplos

En el ejemplo siguiente se usa la propiedad StringFormat para convertir Price, que es un Double, en una cadena que representa una moneda.The following example uses the StringFormat property to convert Price, which is a Double, to a string that represents a currency.

<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 StringFormat en un MultiBinding para compilar una cadena que incluye el Description y Price de cada elemento de una ListBox.The following example uses the StringFormat property on a MultiBinding to build a string that includes the Description and Price of each item in a 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.StringFormat can be a predefined, composite, or custom string format. Para obtener más información sobre los formatos de cadena, vea aplicar formato a tipos.For more information about string formats, see Formatting Types.

Si establece las propiedades Converter y StringFormat, el convertidor se aplica primero al valor de los datos y, a continuación, se aplica la StringFormat.If you set the Converter and StringFormat properties, the converter is applied to the data value first, and then the StringFormat is applied.

Al establecer el StringFormat en un Binding en un formato de cadena compuesta, solo puede especificar un parámetro.When you set the StringFormat on a Binding to a composite string format, you can specify only one parameter.

Cuando se usa un MultiBinding, la propiedad StringFormat solo se aplica cuando se establece en el MultiBinding.When you use a MultiBinding, the StringFormat property applies only when it is set on the MultiBinding. El valor de StringFormat que se establece en cualquier objeto de Binding secundario se omite.The value of StringFormat that is set on any child Binding objects is ignored. El número de parámetros en un formato de cadena compuesto no puede superar el número de objetos secundarios Binding del MultiBinding.The number of parameters in a composite string format cannot exceed the number of child Binding objects in the MultiBinding.

Al utilizar un PriorityBinding, puede establecer el StringFormat en el PriorityBinding, en los objetos de enlace secundarios o en ambos.When you use a PriorityBinding, you can set the StringFormat on the PriorityBinding, on child binding objects, or both. Si el StringFormat se establece en el enlace secundario que se aplica, se utiliza ese valor.If the StringFormat is set on the child binding that is applied, that value is used. Si el StringFormat no se establece en el enlace secundario que se aplica, se aplica el StringFormat de la PriorityBinding si se establece.If the StringFormat is not set on the child binding that is applied, the StringFormat of the PriorityBinding is applied if it is set.

Se aplica a