# PageNumberFieldCollection.Add Method

> Inserts a new page number field at the current input position of a header or footer.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Reference
- **Kind:** Method
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.WinForms.SDK` (assembly `TXTextControl.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXTextControl.dll` from the setup
- **Path:** TX Text Control .NET for Windows Forms > Reference > TXTextControl > PageNumberFieldCollection.Add Method
- **672 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/pagenumberfieldcollection/add-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/pagenumberfieldcollection/add-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/pagenumberfieldcollection/add-method/llms-full.txt

---

### Description

Inserts a new page number field at the current input position of a header or footer.

### Syntax

```csharp
public bool Add(PageNumberField pageNumberField);
```

```vbnet
Public Function Add(pageNumberField As PageNumberField) As Boolean
```

### Parameters

| Parameter | Description |
|---|---|
| pageNumberField | Specifies the page number field to add. |

### Return Value

The return value is true, if the page number field could be added. Otherwise it is false.

### Examples

The following example builds a “Page X of Y” footer with two page-number fields.

```csharp
textControl.HeadersAndFooters.Add(HeaderFooterType.Footer);
HeaderFooter footer = textControl.HeadersAndFooters.GetItem(HeaderFooterType.Footer);
PageNumberFieldCollection fields = footer.PageNumberFields;
footer.Selection.Text = "Page ";
fields.Add(new PageNumberField());
footer.Selection.Text = " of ";
fields.Add(new PageNumberField() { ShowNumberOfPages = true });
```

```vbnet
textControl.HeadersAndFooters.Add(HeaderFooterType.Footer)
Dim footer As HeaderFooter = textControl.HeadersAndFooters.GetItem(HeaderFooterType.Footer)
Dim fields As PageNumberFieldCollection = footer.PageNumberFields
footer.Selection.Text = "Page "
fields.Add(New PageNumberField())
footer.Selection.Text = " of "
fields.Add(New PageNumberField() With { .ShowNumberOfPages = True })
```

---

## Nearby

- **Previous:** [PageNumberFieldCollection Class](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/pagenumberfieldcollection/llms-full.txt)
- **Next:** [PageNumberFieldCollection.Clear Method](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/pagenumberfieldcollection/clear-method/llms-full.txt)