RelativeSource Constructor (RelativeSourceMode, Type, Int32)

Initializes a new instance of the RelativeSource class with an initial mode and additional tree-walking qualifiers for finding the desired relative source.

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

public RelativeSource(
	RelativeSourceMode mode,
	Type ancestorType,
	int ancestorLevel
)

Parameters

mode
Type: System.Windows.Data.RelativeSourceMode

One of the RelativeSourceMode values. For this signature to be relevant, this should be FindAncestor.

ancestorType
Type: System.Type

The Type of ancestor to look for.

ancestorLevel
Type: System.Int32

The ordinal position of the desired ancestor among all ancestors of the given type.

ancestorType and ancestorLevel have no relevance if given as parameters for a mode other than FindAncestor. Do not use this signature for the other RelativeSourceMode values.

The following returns the second ItemsControl encountered on the upward path starting at the target element of the binding.

Binding myBinding = new Binding();
// Returns the second ItemsControl encountered on the upward path 
// starting at the target element of the binding
myBinding.RelativeSource = new RelativeSource(
    RelativeSourceMode.FindAncestor, typeof(ItemsControl), 2);

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft