IAmbientProvider::GetAllAmbientValues Method (IEnumerable<XamlType^>^, Boolean, IEnumerable<XamlType^>^, array<XamlMember^>^)

.NET Framework (current version)
 

Returns an enumerable set of ambient property information items for the requested set of types and properties.

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

IEnumerable<AmbientPropertyValue^>^ GetAllAmbientValues(
	IEnumerable<XamlType^>^ ceilingTypes,
	bool searchLiveStackOnly,
	IEnumerable<XamlType^>^ types,
	... array<XamlMember^>^ properties
)

Parameters

ceilingTypes
Type: System.Collections.Generic::IEnumerable<XamlType^>^

Specifies one or more types that should stop the evaluation when they are encountered traversing upward in the object graph. This type holds the desired ambient property. May be null.

searchLiveStackOnly
Type: System::Boolean

true to not use a saved context; false to use a saved context. The default is false. See Remarks.

types
Type: System.Collections.Generic::IEnumerable<XamlType^>^

Specifies one or more type identifier objects that identify the types to be considered ambient.

properties
Type: array<System.Xaml::XamlMember^>^

Specifies one or more property identifier objects that identify the properties to be considered ambient.

Return Value

Type: System.Collections.Generic::IEnumerable<AmbientPropertyValue^>^

An enumerable set of ambient property information items for the requested set of types and properties. The property information for each AmbientPropertyValue that is returned will match one of the input types or properties.

Each AmbientPropertyValue that is returned contains the XamlMember identifier and a property value.

This particular GetAllAmbientValues overload can search for ambient types and ambient properties in the same pass through a tree. Using this overload results in an ordering of items in the return value that is different from GetAllAmbientValues(IEnumerable<XamlType^>^, array<XamlMember^>^) or GetAllAmbientValues(array<XamlType^>^).

This overload also permits the search to not use any saved context. The GetAllAmbientValues(IEnumerable<XamlType^>^, array<XamlMember^>^) or GetAllAmbientValues(array<XamlType^>^) overloads implicitly use a saved context if it is available (they always act as if an implicit searchLiveStackOnly parameter is false). The concept of a saved context is potentially handled differently by particular XAML schema contexts, or by frameworks that incorporate XAML. In the WPF XAML implementation, saved contexts are used for template expansion, as well as other feature areas.

.NET Framework
Available since 4.0
Return to top
Show: