{"id":112668,"date":"2026-09-02T07:00:00","date_gmt":"2026-09-02T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=112668"},"modified":"2026-09-02T21:45:32","modified_gmt":"2026-09-03T04:45:32","slug":"the-perils-of-binding-to-value-types-in-xaml","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20260902-00\/?p=112668","title":{"rendered":"The perils of binding to value types in XAML"},"content":{"rendered":"

A colleague ran into trouble with their XAML program. They were using a FlipView<\/code> control to bind to a collection, but when the user tried to navigate the FlipView<\/code> using an assistive technology tool, there were cases where the navigation failed.<\/p>\n

Some time later, they came back with the solution to the mystery.<\/p>\n

The team noticed that their data model consisted only of strings and other value types, so they decided to declare their data model as a struct<\/code> rather than a full runtimeclass<\/code>, thereby avoiding a lot of boilerplate typing.<\/p>\n

If defined as a runtimeclass<\/code>:<\/p>\n

\/\/ MyComponent.idl\r\nruntimeclass MyPageContent\r\n{\r\n    String Title { get; };\r\n    String Description { get; };\r\n    String LinkUri { get; };\r\n    Boolean IsNew{ get; };\r\n}\r\n\r\n\/\/ MyPageContent.h\r\n\r\nnamespace winrt::MyComponent\r\n{\r\n    struct MyPageContent : implements<MyPageContent>\r\n    {\r\n        MyPageContent(hstring const& title,\r\n                    hstring const& description,\r\n                    hstring const& link,\r\n                    bool isNew) :\r\n            m_title(title),\r\n            m_description(description),\r\n            m_link(link),\r\n            m_isNew(isNew) {}\r\n\r\n        hstring Title() const { return m_title; }\r\n        hstring Description() const { return m_description; }\r\n        hstring Link() const { return m_link; }\r\n        bool IsNew() const { return m_isNew; }\r\n\r\n    private:\r\n        hstring m_title;\r\n        hstring m_description;\r\n        Windows::Foundation::Uri m_link;\r\n        bool m_isNew;\r\n    };\r\n}\r\n\r\n\/\/ Consumer.cpp\r\n\r\nm_pages.Append(winrt::make<MyPageContent>(\r\n                    title, description, link, isNew));\r\n<\/pre>\n
But if you define it as a struct<\/code>, then most of this code isn’t necessary:<\/p>\n
\/\/ MyComponent.idl\r\nstruct<\/span> MyPageContent\r\n{\r\n    String Title;\r\n    String Description;\r\n    String Link;\r\n    Boolean IsNew;\r\n}\r\n\r\n\/\/ MyPageContent.h<\/span> not needed\r\n\r\n\/\/ Consumer.cpp\r\n\r\nm_pages.Append(MyPageContent(title, description, link, isNew));\r\n<\/pre>\n
Tastes great, less filling<\/a>.<\/p>\n
Now, the thing that makes value types value types is that they are copy-by-value, not copy-by-reference. This means that when XAML calls GetAt(n)<\/code> on the m_pages<\/code> to get the n<\/var>th item, it gets a copy<\/i> of the MyPageContent<\/code> and binds to the copy.<\/p>\n
And that’s the source of the problem.<\/p>\n
When the code wants to navigate to a specific item at the request of the assistive technology tool, it passes the MyPageContent<\/code> to navigate to, but that’s just another copy because value types are always passed by copy. XAML says, “I don’t have that guy” and fails the navigation. (XAML doesn’t realize that it has a guy who looks just like<\/i> that guy. Not that it matters, because it’s not the same guy.)<\/p>\n
The clever shortcut turned out to be the problem.<\/p>\n
Now, while it’s true that there’s a bunch of typing needed to implement a C++\/WinRT runtime class, there are helpers to reduce the amount of typing required. In the Windows Implementation Library (wil), the cppwinrt_authoring.h<\/code> header contains classes to simplify the implementation of events and properties. It exploits CRTP  in the same way I discussed some time ago<\/a>.<\/p>\n
\/\/ MyPageContent.h\r\n\r\nnamespace winrt::MyComponent\r\n{\r\n    struct MyPageContent : implements<MyPageContent>\r\n    {\r\n        MyPageContent(hstring const& title,\r\n                    hstring const& description,\r\n                    hstring const& link,\r\n                    bool isNew) :\r\n            m_title(title),\r\n            m_description(description),\r\n            m_link(link),\r\n            m_isNew(isNew) {}\r\n\r\n        wil::single_threaded_property<hstring> Title;      <\/span>\r\n        wil::single_threaded_property<hstring> Description;<\/span>\r\n        wil::single_threaded_property<hstring> Link;       <\/span>\r\n        wil::single_threaded_property<bool> IsNew;         <\/span>\r\n    };\r\n}\r\n<\/pre>\n
We can get away with using a single_threaded_property<\/code> because the properties are written only at construction, so concurrent reads are not going to cause problems.<\/p>\n","protected":false},"excerpt":{"rendered":"
Loss of identity.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-112668","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Loss of identity.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/112668","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=112668"}],"version-history":[{"count":1,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/112668\/revisions"}],"predecessor-version":[{"id":112669,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/112668\/revisions\/112669"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=112668"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=112668"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=112668"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}