• Article

PropertyPath Constructor (String, array<Object[])

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the PropertyPath class.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Sub New ( _
    path As String, _
    ParamArray pathParameters As Object() _
)

public PropertyPath(
    string path,
    params Object[] pathParameters
)

Parameters

  • pathParameters
    Type: array<System.Object[]
    Do not use. See Remarks.

Exceptions

Exception Condition
ArgumentOutOfRangeException

Provided an array of length greater than zero for pathParameters.

Remarks

In Silverlight 5, you typically construct a PropertyPath based on a string, regardless of intended usage. See Property Path Syntax for a guide to constructing a PropertyPath based on a string, with separate syntax guidance for each usage.

The WPF implementation of PropertyPath can use a different convention for the meaning of the path and pathParameters parameters, which treats path as a token string and pathParameters as an array of various types that describe properties in the .NET Framework type system. This convention supported advanced timelines. Silverlight does not support this alternate convention. Always use the path parameter to specify a path string as documented in the topic Property Path Syntax, and do not specify pathParameters. Alternatively, use the PropertyPath(Object) signature. If left unspecified, the params keyword for the pathParameters parameter enables the creation of a zero-length object array implicitly, and the zero-length array is the only expected value for pathParameters in Silverlight.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.