Skip to content

Latest commit

 

History

History
42 lines (29 loc) · 2.19 KB

binding_converterparameter.md

File metadata and controls

42 lines (29 loc) · 2.19 KB
-api-id -api-type
P:Windows.UI.Xaml.Data.Binding.ConverterParameter
winrt property

Windows.UI.Xaml.Data.Binding.ConverterParameter

-description

Gets or sets a parameter that can be used in the Converter logic.

-xaml-syntax

<Binding ConverterParameter="parameter"/>
-or-
<Binding ConverterParameter="parameterReference"/>

-xaml-values

parameter
parameterA parameter value that is either a primitive value, or can be type converted from a string.
parameterReference
parameterReferenceA parameter value that is obtained as a reference to an already existing object. Typically the object is created in a ResourceDictionary and given a key, then referenced by using the {StaticResource} markup extension.
## -property-value A parameter to be passed to the [Converter](binding_converter.md). This can be used in the conversion logic. The default is **null**.

-remarks

Passing parameters to a converter is a relatively advanced and uncommon scenarios. Most converters used for data binding simply type-convert a source object to a desired target type based solely on the characteristics of the source object, and knowing what the intended destination type is for a particular binding scenario.

If a value for ConverterParameter is specified, this value is used for the parameter value when invoking the converter logic. Specifically, this provides the value of the parameter parameter of the Convert or ConvertBack methods of the specific converter that is requested with the Converter property.

You can't set the property values of a Binding object after that binding has been attached to a target element and target property. If you attempt this you'll get a run-time exception.

-examples

-see-also

Converter, XAML data binding sample, Data binding in depth