# Troubleshooting

> Solve problems with TX Text Control .NET for WPF: packages, the XAML Designer, initialization, binding, licenses, native libraries, fonts and deployment.

- **Product:** TX Text Control .NET for WPF
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Text Control .NET for WPF > Troubleshooting
- **1456 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/llms-full.txt

---

A package isn't found, the XAML Designer asks to restart, code in the constructor has no effect or the application fails on the machine of a user. What you see usually tells you where to look, and each page of Troubleshooting starts from such a symptom, quotes the message where TX Text Control shows one, explains the cause and gives the steps that fix it.

### Find the Right Page

| If you see | Read |
|---|---|
| A package isn't found, doesn't install or doesn't fit the target framework | [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/installation/llms-full.txt) |
| The XAML Designer asks to restart, the toolbox tab is missing, or the bars aren't connected | [Toolbox and XAML Designer](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/toolbox/llms-full.txt) |
| XAML doesn't recognize the controls, or the project references old assemblies | [XAML Namespaces and Assembly References](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/xaml-namespaces/llms-full.txt) |
| Code in the constructor of the window has no effect or fails | [Control Initialization](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/initialization/llms-full.txt) |
| A binding to the formatting doesn't update, or a property can't be a binding target | [Data Binding and Commands](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/data-binding/llms-full.txt) |
| The window freezes while documents are processed, or an exception ends the application | [Dispatcher and Thread Access](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/dispatcher/llms-full.txt) |
| "The following control could not be licensed", an expired trial or a `LicenseLevelException` | [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/llms-full.txt) |
| "The TX Text Control kernel DLL file could not be found", or the application fails when the engine starts | [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/native-libraries/llms-full.txt) |
| Text in another font, moved line and page breaks, or a PDF/A document that can't be saved | [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt) |
| Blurry icons of your own buttons, or a zoom factor that isn't applied | [DPI and Scaling](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/dpi-scaling/llms-full.txt) |
| Printing is disabled, ignores the print dialog or looks different from the screen | [Printing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/printing/llms-full.txt) |
| A `FilterException`, or a loaded or converted document that looks wrong | [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/llms-full.txt) |
| Merge fields or blocks that stay empty or disappear | [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/mail-merge/llms-full.txt) |
| An application that runs on your machine but not on the machine of a user | [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/deployment/llms-full.txt) |

### Collect the Evidence First

Most problems are quicker to solve with the right information at hand:

- **The version and edition.** `GetVersionInfo` returns the product level and the service pack the application runs with. See [Check Which Edition Your Application Runs](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/#check-which-edition-your-application-runs).
- **The reason of an exception.** A `FilterException` names its cause in its `Reason` property and an error number in its message. See [Read the Reason of a FilterException](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/#read-the-reason-of-a-filterexception).
- **The replaced fonts.** The `AdaptFont` event reports every font that isn't available. See [Find Out Which Fonts Are Replaced](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/#find-out-which-fonts-are-replaced).
- **When your code runs.** Code that runs before the `Loaded` event of the `TextControl` finds a control that isn't ready. See [Control Initialization](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/initialization/llms-full.txt).

### Check the Known Issues

Text Control keeps a list of known issues for each major version, on the page [Known Issues of TX Text Control .NET for WPF 34.0](https://www.textcontrol.com/product/tx-text-control-dotnet-wpf/issue/3400/). It names each issue with its ID and area, groups the closed issues by the service pack that fixed them, and lists the issues that are still open. The service pack announcements on the blog link the same page.

1. Read the service pack your application runs with, as [Check Which Edition Your Application Runs](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/#check-which-edition-your-application-runs) and [Service Packs](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/service-packs/#check-the-installed-service-pack) show.
2. Look for your problem on the page. If a later service pack fixed it, install that service pack, update the package and rebuild the application.
3. If the issue is open, it isn't fixed yet in any service pack of the version.

For an earlier major version, replace `3400` in the address with its number, such as `3300` for version 33.0.

### Contact Text Control Support

When neither these pages nor the known issues solve the problem, contact Text Control through the [contact page](https://www.textcontrol.com/contact/). A subscription includes technical support by email, telephone and chat, with no limit on the number of incidents; see [Subscription and Updates](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/overview/licensing/#subscription-and-updates). Send the evidence listed above with your request: the version, the edition, the service pack and the complete message with its error number.

### Where to Start

1. **A new project doesn't build or run:** start with [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/installation/llms-full.txt), then [Toolbox and XAML Designer](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/toolbox/llms-full.txt), [XAML Namespaces and Assembly References](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/xaml-namespaces/llms-full.txt) and [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/llms-full.txt).
2. **The editor doesn't behave as expected:** [Control Initialization](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/initialization/llms-full.txt) first, then [Data Binding and Commands](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/data-binding/llms-full.txt).
3. **The application fails on another machine:** [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/deployment/llms-full.txt) first, then [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/native-libraries/llms-full.txt).
4. **Documents look wrong:** [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt) first, then [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/llms-full.txt).
5. **Nothing on these pages matches:** check the [known issues](#check-the-known-issues) of your version.

If a problem started after an update, check the [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/breaking-changes/llms-full.txt) of the versions you skipped. The [Deployment Guide](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/deployment/llms-full.txt) shows complete setups that avoid many of these problems.

---

## In This Section

- [Document Conversion](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/llms-full.txt): Fix FilterException errors when a WPF TextControl loads or saves: wrong StreamType, protected PDFs, PDFs without text, missing images and Word fields.
- [Data Binding and Commands](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/data-binding/llms-full.txt): Fix data binding problems with TX Text Control .NET for WPF: bindings to InputFormat, Content set twice, properties that can't be targets, and commands.
- [Deployment](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/deployment/llms-full.txt): Fix WPF applications that fail on the target machine: files missing from the executable folder, publishing for win-x64, MSXML and installers with old DLL names.
- [Dispatcher and Thread Access](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/dispatcher/llms-full.txt): Keep a WPF application with TX Text Control responsive: ServerTextControl for work without a user interface, parallel merges and unhandled exceptions.
- [DPI and Scaling](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/dpi-scaling/llms-full.txt): Fix scaling problems of TX Text Control .NET for WPF: blurry icons in your own buttons, a ResourceProvider call that throws, and zoom values out of range.
- [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt): Find replaced fonts with AdaptFont in a WPF application, keep line and page breaks stable with FormattingPrinter, and save PDF/A with EmbeddableFontsOnly.
- [Control Initialization](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/initialization/llms-full.txt): Fix initialization problems of TX Text Control .NET for WPF: code that runs before the TextControl is loaded, ResourceProvider calls and ServerTextControl.
- [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/installation/llms-full.txt): Fix restore problems of TXTextControl.TextControl.WPF.SDK: the offline package source, private feed credentials, .NET 8 targets, build servers and updates.
- [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/llms-full.txt): Fix WPF license errors: controls that could not be licensed, txtextcontrol.wpf.license, licenses.licx versions, EntryAssembly in libraries and the trial.
- [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/mail-merge/llms-full.txt): Fix MailMerge results in WPF: fields that stay empty, merge blocks that don't repeat, cultures, JSON ParserException and data source config files that throw.
- [Native Libraries and Architecture Mismatches](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/native-libraries/llms-full.txt): Fix the kernel DLL not found error in WPF applications: x86 and x64 native libraries, AnyCPU builds, VCRUNTIME140.DLL, renamed DLLs and Create returning false.
- [Printing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/printing/llms-full.txt): Fix printing problems of TX Text Control .NET for WPF: disabled printing, ignored print dialog settings, breaks that differ from the screen, PrintDocument jobs.
- [Toolbox and XAML Designer](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/toolbox/llms-full.txt): Fix toolbox and XAML Designer problems of TX Text Control .NET for WPF: the restart prompt, a missing toolbox tab, bars that aren't connected, old versions.
- [XAML Namespaces and Assembly References](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/xaml-namespaces/llms-full.txt): Fix XAML namespace and reference problems of TX Text Control .NET for WPF: the xmlns declaration, the prefix, and references to the assemblies of old versions.

---

## Nearby

- **Previous:** [Performance Best Practices](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/performance/best-practices/llms-full.txt)
- **Next:** [Installation and Package Restore](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/installation/llms-full.txt)