# X14 Preview: Adding MS Word Compatible Custom Properties to Documents

> TX Text Control X14 introduces the UserDefinedPropertyDictionary class for storing custom document properties compatible with MS Word. Properties support String, Boolean, Int32, and Double types and persist across DOCX, DOC, RTF, and TX formats using SaveSettings and LoadSettings.

- **Author:** Bjoern Meyer
- **Published:** 2016-11-09
- **Modified:** 2026-07-17
- **Description:** TX Text Control X14 introduces the UserDefinedPropertyDictionary class for storing custom document properties compatible with MS Word. Properties support String, Boolean, Int32, and Double types and persist across DOCX, DOC, RTF, and TX formats using SaveSettings and LoadSettings.
- **2 min read** (277 words)
- **Tags:**
  - ASP.NET
  - Release
  - Windows Forms
  - WPF
- **Web URL:** https://www.textcontrol.com/blog/2016/11/09/x14-preview-adding-ms-word-compatible-custom-properties-to-documents/
- **LLMs URL:** https://www.textcontrol.com/blog/2016/11/09/x14-preview-adding-ms-word-compatible-custom-properties-to-documents/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2016/11/09/x14-preview-adding-ms-word-compatible-custom-properties-to-documents/llms-full.txt

---

Custom properties can be created to store additional information about the document in the document itself. These properties remain with a document and can be viewed by all MS Word users that open the document. Several property management servers provide data tracking capabilities to search for, sort, and track documents based on document properties.

Using TX Text Control X14 (Windows Forms, WPF and ASP.NET), custom properties can be set and retrieved using the *SaveSettings* and *LoadSettings* parameter in the [Load](https://docs.textcontrol.com/textcontrol/windows-forms/ref.txtextcontrol.textcontrol.load.method.htm) and [Save](https://docs.textcontrol.com/textcontrol/windows-forms/ref.txtextcontrol.textcontrol.save.method.htm) methods.

The new class *UserDefinedPropertyDictionary* contains all custom properties stored in a document. Supported value types are:

- System.String
- System.Boolean
- System.Int32
- System.Double

The following sample code shows how to add new custom properties to a document:

```
TXTextControl.UserDefinedPropertyDictionary userSettings =
    new TXTextControl.UserDefinedPropertyDictionary();

userSettings.Add("CustomPropertyString", "Custom property string");
userSettings.Add("CustomPropertyInt32", 123);
userSettings.Add("CustomPropertyBoolTrue", true);
userSettings.Add("CustomPropertyBoolFalse", false);
userSettings.Add("CustomPropertyDouble", 123.232);

TXTextControl.SaveSettings saveSettings = new TXTextControl.SaveSettings() {
    UserDefinedDocumentProperties = userSettings
};

textControl1.Save("test.rtf", 
                  TXTextControl.StreamType.RichTextFormat, 
                  saveSettings);
```

Unlimited number of custom properties can be stored in the document formats MS Word (DOC), Office Open XML (DOCX), Rich Text Format (RTF) and the internal TX Text Control format (TX).

The following code snippet shows how to load and retrieve the custom properties stored in a document:

```
TXTextControl.LoadSettings loadSettings = new TXTextControl.LoadSettings();

textControl1.Load("test.rtf", 
                  TXTextControl.StreamType.RichTextFormat,
                  loadSettings);

foreach (DictionaryEntry property in loadSettings.UserDefinedDocumentProperties) {
    Console.WriteLine(property.Key + ": " + property.Value.ToString());
}
```

Stay tuned for more information about the upcoming release X14!

---

## About Bjoern Meyer

As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano.

- [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/)
- [X](https://x.com/txbjoern)
- [GitHub](https://github.com/bjoerntx)

---

## Related Posts

- [TX Text Control 34.0 SP5 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2026/09/14/tx-text-control-34-0-sp5-is-now-available/llms.txt)
- [TX Text Control 34.0 SP4 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2026/05/20/tx-text-control-34-0-sp4-is-now-available/llms.txt)
- [TX Spell .NET 11.0 SP1 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2026/04/08/tx-spell-net-11-0-sp1-is-now-available/llms.txt)
- [TX Text Control 34.0 SP2 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2026/02/18/tx-text-control-34-0-sp2-is-now-available/llms.txt)
- [TX Text Control 34.0 SP1 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2025/12/03/tx-text-control-34-0-sp1-is-now-available/llms.txt)
- [Introducing TX Text Control 34.0: Your Next Leap in Document Processing](https://www.textcontrol.com/blog/2025/11/10/introducing-tx-text-control-34-0-your-next-leap-in-document-processing/llms.txt)
- [Sneak Peek: TX Text Control 34.0 Coming November 2025](https://www.textcontrol.com/blog/2025/10/02/sneak-peek-tx-text-control-34-0-coming-november-2025/llms.txt)
- [TX Text Control 33.0 SP3 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2025/08/14/tx-text-control-33-0-sp3-is-now-available/llms.txt)
- [TX Text Control 33.0 SP2 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2025/06/18/tx-text-control-33-0-sp2-is-now-available/llms.txt)
- [Service Pack Releases: What's New in TX Text Control 33.0 SP1 and 32.0 SP5](https://www.textcontrol.com/blog/2025/05/07/service-pack-releases-whats-new-in-tx-text-control-33-0-sp1-and-32-0-sp5/llms.txt)
- [The Wait is Over: TX Text Control for Linux is Officially Here](https://www.textcontrol.com/blog/2025/03/12/the-wait-is-over-tx-text-control-for-linux-is-officially-here/llms.txt)
- [Full .NET 9 Support in Text Control .NET Components for ASP.NET Core, Windows Forms, and WPF](https://www.textcontrol.com/blog/2024/11/11/full-net-9-support-in-text-control-net-components-for-asp-net-core-windows-forms-and-wpf/llms.txt)
- [TX Text Control 32.0 Service Pack 4 Released](https://www.textcontrol.com/blog/2024/09/02/tx-text-control-32-0-service-pack-4-released/llms.txt)
- [Service Pack 3: MailMerge Supports SVG Images](https://www.textcontrol.com/blog/2024/04/29/service-pack-3-mailmerge-supports-svg-images/llms.txt)
- [TX Text Control 32.0 Service Pack 3 Released](https://www.textcontrol.com/blog/2024/04/29/tx-text-control-32-0-service-pack-3-released/llms.txt)
- [32.0 Service Pack 2: Licensing, Unit Testing, and Azure DevOps](https://www.textcontrol.com/blog/2024/01/05/32-0-service-pack-2-licensing-unit-testing-and-azure-devops/llms.txt)
- [Service Pack 1 for TX Text Control 32.0 Released](https://www.textcontrol.com/blog/2023/11/22/service-pack-1-for-tx-text-control-32-released/llms.txt)
- [Service Pack 4 for TX Text Control 31.0 Released](https://www.textcontrol.com/blog/2023/09/19/service-pack-4-for-tx-text-control-31-released/llms.txt)
- [TX Text Control 32.0 Has Been Released](https://www.textcontrol.com/blog/2023/09/13/tx-text-control-320-has-been-released/llms.txt)
- [Sneak Peek 32.0: Modifying the Normal Stylesheet](https://www.textcontrol.com/blog/2023/07/04/sneak-peek-320-modifying-the-normal-stylesheet/llms.txt)
- [Sneak Peek 32.0: Introducing Footnotes](https://www.textcontrol.com/blog/2023/06/23/sneak-peek-320-introducing-footnotes/llms.txt)
- [Service Pack 3 for TX Text Control 31.0 Released](https://www.textcontrol.com/blog/2023/06/22/service-pack-3-for-tx-text-control-31-released/llms.txt)
- [Service Pack 2 for TX Text Control 31.0 Released](https://www.textcontrol.com/blog/2023/02/22/service-pack-2-for-tx-text-control-31-released/llms.txt)
- [Service Pack 1 for TX Text Control 31.0 Released](https://www.textcontrol.com/blog/2022/12/16/service-pack-1-for-tx-text-control-31-released/llms.txt)
- [Service Pack 3 for TX Text Control 30.0 Released](https://www.textcontrol.com/blog/2022/09/20/service-pack-3-for-tx-text-control-30-released/llms.txt)
