# GitHub Examples

> Sample projects of TX Text Control .NET for Windows Forms on GitHub: TXSamples_WinForms_CSharp, blog samples, and updating a sample to the current version.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Text Control .NET for Windows Forms > Examples > GitHub Examples
- **1627 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/github/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/github/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/github/llms-full.txt

---

Text Control publishes the sample applications of TX Text Control .NET for Windows Forms on GitHub, in the organization [TextControl](https://github.com/TextControl): the official samples that the setup also installs, and the projects behind articles of the Text Control Blog. Most of them were written for an earlier version, so knowing how a sample references TX Text Control, and what to change, saves time when you run one for the first time.

### What the Organization Contains

- **The sample index.** [TXSamples.NET](https://github.com/TextControl/TXSamples.NET) lists the official sample repositories of all .NET products of Text Control.
- **The official Windows Forms samples.** [TXSamples\_WinForms\_CSharp](https://github.com/TextControl/TXSamples_WinForms_CSharp) and [TXSamples\_WinForms\_VB.NET](https://github.com/TextControl/TXSamples_WinForms_VB.NET) contain 18 sample applications in three categories, each once for the .NET Framework 4.8 (folder *.NET-Framework-48*) and once for .NET 6 (folder *.NET-Core-6*):
    - *Tutorial*: a form with a `TextControl`, a ribbon with five tabs, two ruler bars and a status bar.
    - *Howto*: charts, hyperlinks, mail merge, the mini toolbar, spreadsheet formulas in tables and XML files.
    - *TX Words*: the word processor sample and the samples built on it; see [TX Words Sample Application](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/tx-words/llms-full.txt).
- **Blog samples.** Many articles of the Text Control Blog come with a repository. Their names start with `TextControl.WindowsForms.`, `TextControl.Windows.Forms.`, `TXTextControl.Windows.Forms.` or `TextControl.`, and most are small projects in C# for the .NET Framework.
- **Other products.** The organization also contains samples for TX Text Control .NET for WPF, TX Text Control .NET Server, TX Spell .NET and DS Server. The examples pages of this section list only samples you can use in Windows Forms.
- **Agent Skills.** The repositories [txtextcontrol-document-editor-skills](https://github.com/TextControl/txtextcontrol-document-editor-skills) and [txtextcontrol-servertextcontrol-skills](https://github.com/TextControl/txtextcontrol-servertextcontrol-skills) hold skills for AI coding assistants, written for the Document Editor and `ServerTextControl` of TX Text Control .NET Server. [AI Coding Assistants](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/integration/coding-assistants/llms-full.txt) explains what they cover and how to connect an assistant to the Text Control MCP Server.

The blog article [Official TX Text Control .NET Sample Applications Are Now Hosted on GitHub](https://www.textcontrol.com/blog/2023/01/08/official-tx-text-control-net-sample-applications-are-now-hosted-on-github/) introduced the official repositories.

### Run a Sample

You need Visual Studio and TX Text Control .NET for Windows Forms: the setup of the full or the trial version provides the assemblies, the NuGet package and the license. See [Installing the Product](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/setup/llms-full.txt).

Clone the repository and open the project or solution file of a sample in Visual Studio. The official samples have no solution file; each sample is a project in its own folder:

```bash
git clone https://github.com/TextControl/TXSamples_WinForms_CSharp.git
```

None of the repositories contains a *nuget.config* file. Projects for .NET get the package `TXTextControl.TextControl.WinForms.SDK` from the package source **Text Control Offline Packages** that the setup adds, as [Configuring Package Sources](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/nuget/sources/#text-control-offline-packages) describes. Update a sample before you build it, as described below.

### Update an Older Sample

The official samples on GitHub were last updated for version 32.0, and the blog samples reference versions from 31.0 to 34.0. The setup installs the samples of the current version; for those on GitHub, a few changes are needed.

#### .NET Samples

The projects in *.NET-Core-6* target `net6.0-windows` and reference `TXTextControl.TextControl.WinForms.SDK` in version `32.0.*`. A few blog samples target .NET 8 with version 33.0.0. The package of version 34.0 requires .NET 8 or higher.

1. Change the target framework in the *.csproj* file to `net8.0-windows` or higher.
2. Update `TXTextControl.TextControl.WinForms.SDK` to the current version, 34.0.5. See [Installing and Updating Packages](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/nuget/install-update/llms-full.txt).
3. Delete *Properties\\licenses.licx* and the line of the *.csproj* file that embeds it, if the project has one. Since Service Pack 2 of version 32.0, .NET projects no longer use *licenses.licx*: the package adds the license file *txtextcontrol.winforms.license*. See [Development Licenses](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/licensing/development/llms-full.txt).

#### .NET Framework Samples

The projects in *.NET-Framework-48* and most blog samples reference the assemblies *TXTextControl.dll* and *TXTextControl.Windows.Forms.dll* of one version, many also further TX Text Control assemblies such as *TXDrawing.dll*, *TXBarcode.dll* and *TXDocumentServer.dll*. Some blog samples reference them with a path to the installation directory of that version.

1. Remove the references to the TX Text Control assemblies and add them again from the *Assembly* folder of your installation.
2. In *Properties\\licenses.licx*, change the version in each entry to the version of the new assemblies.
3. Rebuild the project.

[Upgrade a .NET Framework Project](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/upgrading/previous-versions/#upgrade-a-net-framework-project) describes these steps in detail, and [Migrating from .NET Framework to .NET](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/upgrading/from-dotnet-framework/llms-full.txt) moves a sample to .NET 8. The blog article [Upgrading a .NET Framework Windows Forms App to a .NET 8 Windows Forms App with TX Text Control 32.0 SP2](https://www.textcontrol.com/blog/2024/01/16/upgrading-a-net-framework-windows-forms-app-to-a-net-6-windows-forms-app-with-tx-text-control-32-0-sp2/) walks through such a move.

### Where to Start

| Example | What it shows | Where |
|---|---|---|
| Official samples in C# | The tutorial, the how-to samples and the TX Words samples for the .NET Framework 4.8 and .NET 6. Version 32.0 | [TXSamples\_WinForms\_CSharp](https://github.com/TextControl/TXSamples_WinForms_CSharp) |
| Official samples in Visual Basic | The same samples in Visual Basic. Version 32.0 | [TXSamples\_WinForms\_VB.NET](https://github.com/TextControl/TXSamples_WinForms_VB.NET) |
| Sample index | The official sample repositories of all .NET products | [TXSamples.NET](https://github.com/TextControl/TXSamples.NET) |

The blog samples are listed by topic on the pages below.

### Samples by Topic

- [TX Words Sample Application](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/tx-words/llms-full.txt), [Document Editor Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/document-editor/llms-full.txt) and [Ribbon and Sidebar Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/ribbon-sidebar/llms-full.txt)
- [Document Processing Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/document-processing/llms-full.txt) and [Mail Merge Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/mail-merge/llms-full.txt)
- [PDF Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/pdf/llms-full.txt) and [Digital Signature Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/digital-signatures/llms-full.txt)

### Next Steps

- [TX Words Sample Application](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/tx-words/llms-full.txt): the largest sample and the projects built on it.
- [Create Your First Windows Forms Application](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/getting-started/document-editor/first-application/llms-full.txt): build an editor step by step.
- [Upgrading from Previous Versions](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/installation/upgrading/previous-versions/llms-full.txt): move a project to the current version.

---

## Nearby

- **Previous:** [TX Words Sample Application](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/tx-words/llms-full.txt)
- **Next:** [Document Editor Examples](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/examples/document-editor/llms-full.txt)
