# Document Conversion > Fix FilterException errors when a WPF TextControl loads or saves: wrong StreamType, protected PDFs, PDFs without text, missing images and Word fields. - **Product:** TX Text Control .NET for WPF - **Section:** Documentation - **Kind:** Topic - **Path:** TX Text Control .NET for WPF > Troubleshooting > Document Conversion - **2796 words** - **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/ - **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/conversion/llms-full.txt --- Loading a document into the `TextControl` or saving it can fail with a `FilterException`, or it succeeds and the result isn't what you expected. Both kinds of problem follow, starting with the exception and its reason. Text that looks different because a font is missing is covered on [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt), and a feature that your edition doesn't include on [Licensing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/licensing/llms-full.txt). ### Read the Reason of a FilterException When a text filter can't convert a document to or from a format, [TextControl.Load](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/textcontrol/load-method/llms-full.txt) and [Save](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/textcontrol/save-method/llms-full.txt) throw a [FilterException](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/filterexception/llms-full.txt). Its message contains an error number in parentheses, and its [Reason](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/filterexception/reason-property/llms-full.txt) property names the cause as a value of [FilterException.FilterError](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/filterexception/filtererror-enumeration/llms-full.txt). The following code in *MainWindow.xaml.cs* loads a document into `textControl1` and shows both when loading fails: ```csharp using System.Windows; using TXTextControl; private void openButton_Click(object sender, RoutedEventArgs e) { try { textControl1.Load("contract.docx", StreamType.WordprocessingML); } catch (FilterException exception) { // The message contains the error number, Reason the cause MessageBox.Show($"{exception.Reason}: {exception.Message}"); } } ``` The reasons have these meanings: | Reason | Meaning | |---|---| | `WrongFileType` | The file type is not supported through the filter. | | `BadToken` | There is a logical error in the file. | | `OutOfMemory` | Unable to allocate enough memory. | | `CannotRead`, `CannotWrite`, `CannotOpen` | The file can't be read, written or opened. | | `FileTooBig` | The input file is too big. | | `Unsupported` | Unsupported format version. | | `Internal` | Unspecified internal error. | | `Obsolete` | The filter is obsolete. | | `NotWellFormed` | The file contains not well-formed syntax. | | `Encrypted` | The document cannot be imported because the used encryption scheme is not supported. | | `NonEmbeddableFont` | The document cannot be saved, because it contains a non-embeddable font. See [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt). | | `InvalidCertificate` | The specified certificate is invalid or has no private key. | | `InvalidTimeServer` | The specified time server does not exist or retrieves invalid data. | | `InvalidPassword` | The specified user-password is invalid. | The error number gives more detail than the reason. Text Control's Error Navigator looks it up; the blog article [Text Control Error Navigator Launched](https://www.textcontrol.com/blog/2022/08/15/text-control-error-navigator-launched/) explains how to search it. ### The File Type Is Not Supported Through the Filter Loading fails with a message such as: ```text Text filter error: The file type is not supported through the filter. (1-1D01) ``` The reason is `WrongFileType`: the data doesn't have the format that the format value of `Load` names, for example a string of plain text loaded as RTF. 1. Pass the value that matches the data: a value of [StreamType](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/streamtype/enumeration/llms-full.txt) for a file, of [BinaryStreamType](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/binarystreamtype/enumeration/llms-full.txt) for a byte array and of [StringStreamType](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/stringstreamtype/enumeration/llms-full.txt) for a string. 2. `BinaryStreamType` has no value for HTML or RTF. Load these formats from a string or a file. 3. `StreamType.AdobePDFA` and `StreamType.CascadingStylesheet` are for saving only. To load a PDF document, use `StreamType.AdobePDF`. [Load and Save Documents](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/getting-started/document-editor/load-save/llms-full.txt) shows which value belongs to which format. ### A Password-Protected PDF Doesn't Load Loading a PDF document throws a `FilterException` whose `Reason` is `InvalidPassword`. The PDF document is protected with a user password, which has to be passed when it's loaded. 1. Ask the user for the password. 2. Load the document again with the password in [LoadSettings.UserPassword](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsavesettingsbase/userpassword-property/llms-full.txt). 3. Read [LoadSettings.DocumentAccessPermissions](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/documentaccesspermissions-property/llms-full.txt) and disable what the document doesn't allow. [Open a Password-Protected PDF](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/pdf/passwords/#open-a-password-protected-pdf) shows the code. If the `Reason` is `Encrypted`, the document uses an encryption that TX Text Control can't import, such as 256-bit AES; [Encrypted PDF Documents](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/pdf/import/#encrypted-pdf-documents) lists the encryptions it imports. ### A Loaded PDF Contains No Text A PDF document loads without an error, but the editor shows no text, or the text can't be selected. A PDF document describes what each character looks like and where it is, but not always which character it is. Most PDF documents contain a mapping to the characters, and without it no text can be extracted. A scanned page is an image and contains no text at all. 1. Check the text after loading, for example with [ServerTextControl.Text](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/servertextcontrol/text-property/llms-full.txt) when you convert without the editor, and skip or report documents without text. 2. Run scanned documents through OCR software before you import them. 3. To read text together with its position on the page, use [PDF.Contents.Lines](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-pdf/contents-lines/llms-full.txt), as [Text Extraction](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/pdf/text-extraction/llms-full.txt) describes. ### The TXTextControl Object Must Have Been Completely Loaded A member of a `ServerTextControl` throws this message: ```text The TXTextControl object must have been completely loaded to use this method. ``` The instance isn't initialized. [ServerTextControl.Create](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/servertextcontrol/create-method/llms-full.txt) must be called before any other member, and it returns `false` when the object couldn't be initialized. 1. Call `Create` directly after `new ServerTextControl()`, before `Load` or any other member. 2. Check the return value of `Create`, and don't use the instance when it's `false`. 3. Create every instance in a `using` block, so that it's disposed. `Create` returns `false` when no new window handle can be created: instances that aren't disposed keep their handles, and Windows allows 10,000 USER handles and 10,000 GDI handles per process. [Watch Instances and Handles](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/performance/memory-usage/#watch-instances-and-handles) shows how to count them. ### Images Are Missing After Loading Where an image should be, the document shows a rectangle of the image's size with the file name of the image. An image inserted from a file can be saved as a reference to the file, with its absolute path. When the document is loaded on a machine where this path doesn't exist, the image can't be found. [LoadSettings.LoadImages](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/loadimages-property/llms-full.txt) set to `false` shows the same rectangles. 1. Set [LoadSettings.ImageSearchPath](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/imagesearchpath-property/llms-full.txt) to the folder that holds the images. It replaces the absolute paths in the document. Relative paths are resolved with [DocumentBasePath](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsavesettingsbase/documentbasepath-property/llms-full.txt). 2. Make sure `LoadImages` isn't `false`. 3. To find the paths a template uses, read [Image.FileName](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/image/filename-property/llms-full.txt) of its images. ### Word Fields Are Missing After Loading A DOCX, DOC or RTF document from Microsoft Word loads, but its merge fields or other fields aren't in [TextControl.ApplicationFields](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-wpf/textcontrol/applicationfields-property/llms-full.txt), or its merge blocks aren't recognized. By default, fields of other applications are not imported as application fields: [LoadSettings.ApplicationFieldFormat](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/applicationfieldformat-property/llms-full.txt) is `None`. Bookmarks that span several characters, which mark merge blocks in Word documents, become document targets unless you load them as subtext parts. 1. Set `ApplicationFieldFormat` to `MSWord` to import the fields of Word as application fields, or to `MSWordTXFormFields` to import its form fields as form fields of TX Text Control. 2. Set [LoadSettings.LoadSubTextParts](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/loadsubtextparts-property/llms-full.txt) to `true` to load bookmarks that span several characters as subtext parts. It applies to DOCX, DOC and RTF. 3. Pass the `LoadSettings` to `Load`. [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/mail-merge/llms-full.txt) covers fields and blocks that don't merge. ### The Converted Document Looks Different A document converted to another format, such as DOCX to PDF, has other line breaks, page breaks or fonts than the original. TX Text Control lays out a document with the fonts available on the machine and the text dimensions of the formatting printer. When a font of the document is missing, another one replaces it, and the layout changes. 1. Find out which fonts are replaced, as [Fonts and Document Layout](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/fonts/llms-full.txt) describes. 2. Check that the format you save to supports what the document contains. [Supported File Formats](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/overview/file-formats/llms-full.txt) lists the formats and their features. 3. Check that your edition includes the format. See [Editions and Feature Availability](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/overview/editions/llms-full.txt). ### Saving as PDF Fails in an Earlier Service Pack Saving a document as PDF or PDF/A fails with a `FilterException` whose message contains an error number such as `01-1D09`, or the saved PDF lacks content, while other documents save without problems. The PDF export of version 34.0 writes tagged PDF, and the service packs of 34.0 fixed several documents that it couldn't save. The Known Issues page of version 34.0 lists, among others, these fixes: | Fixed in | Documents that failed or were saved incompletely | |---|---| | Service Pack 1 | Saving as PDF or PDF/A hung the `TextControl` or `ServerTextControl` | | Service Pack 2 | Lists mixed with normal paragraphs, text frames, Unicode characters, table headers in PDF/A, invalid links in PDF/A, and check box form fields in PDF/A | | Service Pack 4 | Lists mixed with paragraphs without list levels, lists and content in headers or footers, styles with a structure level above 6, signature fields outside the first or last paragraph, and invalid XRechnung PDF documents | | Service Pack 5 | Images with a compression quality of 100, SVG images with embedded PNG images in signature fields, and the font of form fields | 1. Read the service pack your application runs with from [VersionInfo.ServicePack](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/versioninfo/servicepack-property/llms-full.txt), as [Service Packs](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/service-packs/#check-the-installed-service-pack) shows. 2. Install the latest service pack, update `TXTextControl.TextControl.WPF.SDK` to 34.0.5 and rebuild the application. 3. If the error remains, look up the error number as described in [Read the Reason of a FilterException](#read-the-reason-of-a-filterexception), and check the open issues on the [Known Issues](https://www.textcontrol.com/product/tx-text-control-dotnet-wpf/issue/3400/) page. An error `1-1D09` when loading some PDF documents is listed there as open. ### Related Pages - [Load and Save Documents](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/getting-started/document-editor/load-save/llms-full.txt): load and save documents in the editor. - [Exceptions and Error Handling](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-processing/exceptions/llms-full.txt): the exceptions of TX Text Control in detail. - [Supported File Formats](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/overview/file-formats/llms-full.txt): what each format supports. --- ## Nearby - **Previous:** [Printing](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/printing/llms-full.txt) - **Next:** [Mail Merge](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/troubleshooting/mail-merge/llms-full.txt)