IXamlType interface

Applies to Windows and Windows Phone

Provides the means to report XAML-type system specifics about XAML types. Using this interface contract, XAML parsers can load any custom types and members thereof that are defined in your app and are referenced in XAML files.

Syntax


public interface IXamlType

Attributes

[Version(0x06020000)]
[WebHostHidden()]

Members

The IXamlType interface has these types of members:

Methods

The IXamlType interface has these methods. It also inherits methods from the Object class.

MethodDescription
ActivateInstance Given a XAML type, sets its values for initialization and returns a usable instance.
AddToMap Adds an item to a custom map type.
AddToVector Adds an item to a custom vector type.
CreateFromString Creates a type system representation based on a string. The main scenario for this usage is creating an enumeration value and mapping the appropriate enumeration.
GetMember Returns the IXamlMember information for a specific named member from this IXamlType.
RunInitializer Invokes any necessary pre-activation logic as required by the XAML schema context and its platform dependencies.

 

Properties

The IXamlType interface has these properties.

PropertyAccess typeDescription

BaseType

Read-onlyGets the IXamlType for the immediate base type of the XAML type. Determination of this value is based on the underlying type for core types.

ContentProperty

Read-onlyGets the IXamlMember information for the XAML content property of this IXamlType.

FullName

Read-onlyGets the full class name of the underlying type.

IsArray

Read-onlyGets a value that indicates whether the IXamlType represents an array.

IsBindable

Read-onlyGets a value that declares whether the type is bindable.

IsCollection

Read-onlyGets a value that indicates whether this IXamlType represents a collection.

IsConstructible

Read-onlyGets a value that indicates whether this IXamlType represents a constructible type, as per the XAML definition.

IsDictionary

Read-onlyGets a value that indicates whether this IXamlType represents a dictionary/map.

IsMarkupExtension

Read-onlyGets a value that indicates whether the IXamlType represents a markup extension.

ItemType

Read-onlyGets a value that provides the type information for the Items property of this IXamlType.

KeyType

Read-onlyGets a value that provides the type information for the Key property of this IXamlType, if this IXamlType represents a dictionary/map.

UnderlyingType

Read-onlyGets information for the backing type.

 

Remarks

The Windows Runtime is a native Component Object Model (COM) based API. You can use several languages to write the app code, including Microsoft .NET languages and native C++. The Windows Runtime does not include reflection or a CLR-style type system. In absence of such a type system, the XAML framework for the Windows Runtime needs infrastructure and contracts to recognize and load any custom types that are defined in your app and are referenced in XAML files. The IXamlMember and IXamlType interfaces are the contract. The infrastructure is partially visible as a generated code file XamlTypeInfo.* (remainder of file name varying depending on which language you use). This file contains a partial class that extends the Application class and implements the IXamlMetadataProvider interface. The Windows Runtime XAML framework uses this interface to query for the details of types referenced in XAML files. Other generated files also use IXamlMetadataProvider for discovery.

Note  XamlTypeInfo.* can be found in the obj folder along with other generated files . You may need to enable Show all files to see it. Also, if you want to step into the type definition code, disable the Just my code feature in the debugger options.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Markup
Windows::UI::Xaml::Markup [C++]

Metadata

Windows.winmd

See also

IXamlMetadataProvider
IXamlMember
XAML overview

 

 

Show:
© 2014 Microsoft