# MergeBlockSettings Class

> The MergeBlockSettings class is used to insert a table or paragraph based repeating merge block into a TextControl instance using the DataSourceManager.InsertMergeBlock method.

- **Product:** TX Text Control .NET for WPF
- **Section:** Reference
- **Kind:** Class
- **Introduced:** 24.0
- **Namespace:** `TXTextControl.DocumentServer.DataSources`
- **Package:** `TXTextControl.TextControl.WPF.SDK` (assembly `TXDocumentServer.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXDocumentServer.dll` from the setup
- **Path:** TX Text Control .NET for WPF > Reference > TXTextControl.DocumentServer.DataSources > MergeBlockSettings Class
- **1003 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/llms-full.txt

---

### Description

The MergeBlockSettings class is used to insert a table or paragraph based repeating merge block into a TextControl instance using the [DataSourceManager.InsertMergeBlock](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/datasourcemanager/insertmergeblock-method/llms-full.txt) method.

### Syntax

```csharp
public class MergeBlockSettings
```

```vbnet
Public Class MergeBlockSettings
```

### Examples

The following example creates a Merge Block Settings instance and configures its block template type setting for a document workflow.

```csharp
TXTextControl.DocumentServer.DataSources.MergeBlockSettings mergeBlockSettings = new();
mergeBlockSettings.BlockTemplateType = TXTextControl.DocumentServer.DataSources.BlockTemplateType.TableRow;
```

```vbnet
Dim mergeBlockSettings As New TXTextControl.DocumentServer.DataSources.MergeBlockSettings()
mergeBlockSettings.BlockTemplateType = TXTextControl.DocumentServer.DataSources.BlockTemplateType.TableRow
```

---

## In This Section

- [MergeBlockSettings.AddResult Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/addresult-property/llms-full.txt): Returns whether the new block has successfully been inserted by DataSourceManager.InsertMergeBlock. The default value is SubTextPartCollection.AddResult.Error.
- [MergeBlockSettings.BlockTemplateType Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/blocktemplatetype-property/llms-full.txt): Gets or sets a value of type BlockTemplateType which specifies the type of the inserted repeating block. (paragraph based or table row based)
- [MergeBlockSettings Constructor](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/constructor/llms-full.txt): Initializes a new instance of the MergeBlockSettings class.
- [MergeBlockSettings.CreatedTable Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/createdtable-property/llms-full.txt): Returns the table created by DataSourceManager.InsertMergeBlock if property BlockTemplateType was set to BlockTemplateType.TableRow. The default value is null.
- [MergeBlockSettings.CreateHeaderRow Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/createheaderrow-property/llms-full.txt): If this property is true and property BlockTemplateType is set to BlockTemplateType.TableRow, a table header row is automatically generated.
- [MergeBlockSettings.FieldDisplayMode Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/fielddisplaymode-property/llms-full.txt): Gets or sets a value of type FieldDisplayMode which specifies the content display mode of the inserted fields. Either the field text or the field codes can be displayed.
- [MergeBlockSettings.HighlightColor Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/highlightcolor-property/llms-full.txt): Specifies the color the inserted merge block is highlighted with if the input position is inside the block. The alpha value of the provided color is used.
- [MergeBlockSettings.TableID Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/tableid-property/llms-full.txt): Gets or sets the ID of the table created by DataSourceManager.InsertMergeBlock. Must be 0 (no ID) or a value between 10 and short.MaxValue. The default value is 0.

---

## Nearby

- **Previous:** [MergeBlockInfo.TableName Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblockinfo/tablename-property/llms-full.txt)
- **Next:** [MergeBlockSettings.AddResult Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver-datasources/mergeblocksettings/addresult-property/llms-full.txt)