BindingBase.StringFormat BindingBase.StringFormat BindingBase.StringFormat BindingBase.StringFormat Property

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 StringFormat usa la propiedad Pricepara convertir, que Doublees una, 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 StringFormat usa la propiedad MultiBinding en un para compilar una Description cadena Price que incluye el y de ListBoxcada elemento de.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

StringFormatpuede 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 Converter propiedades y StringFormat , el convertidor se aplica StringFormat primero al valor de los datos y, a continuación, se aplica.If you set the Converter and StringFormat properties, the converter is applied to the data value first, and then the StringFormat is applied.

Cuando se establece StringFormat Binding en un formato de cadena compuesta, solo se 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 StringFormat propiedad solo se aplica cuando se establece en MultiBinding.When you use a MultiBinding, the StringFormat property applies only when it is set on the MultiBinding. Se omite el StringFormat valor de que se establece en Binding los objetos secundarios.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 compuesta no puede superar el número Binding de objetos secundarios MultiBindingde.The number of parameters in a composite string format cannot exceed the number of child Binding objects in the MultiBinding.

Cuando se usa un PriorityBinding, se puede StringFormat establecer en PriorityBinding, en 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. StringFormat Si 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 no StringFormat PriorityBinding se establece en el enlace secundario que se aplica, la de se aplica si se establece. StringFormatIf 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