# PageLabel Class

> Describes numbering labels for a range of pages.

- Product: Adobe PDF Library 21
- Language: .NET Framework
- Version: APDFL21.0.0PlusP1e
- HTML page: https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/PageLabel
- Version index: https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/llms.txt

```csharp
class PageLabel : SystemIDisposable
```

**Namespace:** `Datalogics::PDFL`

**Inherits from:** `SystemIDisposable`

## Description

Describes numbering labels for a range of pages.

PageLabel describes how to construct a label string for a range of pages. It contains information on number style, any prefixes, and a starting position within the document.

Note that a single PageLabel describes the label string for several pages all pages up until the first page covered by the next PageLabel, or the end of the document.

Also note that if a Document has any PageLabels, there must be one that starts at page index 0. This will be automatically created if the user does not supply one.

**Referenced by:** [`Document`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Document.md)

**Uses types:** [`NumberStyle`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/enum/NumberStyle.md)

## Constructors

### PageLabel

```csharp
Datalogics.PDFL.PageLabel.PageLabel(int start, NumberStyle ns)
```

*constructor*

**Parameters**

- `start` (`int`): Starting page index in the Document for this range
- `ns` ([`NumberStyle`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/enum/NumberStyle.md)): Numbering style for this range

Convenience constructor creates a range with no prefix starting with number 1.

### PageLabel

```csharp
Datalogics.PDFL.PageLabel.PageLabel(int start, NumberStyle ns, string p, int first)
```

*constructor*

**Parameters**

- `start` (`int`): Starting page index in the Document for this range
- `ns` ([`NumberStyle`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/enum/NumberStyle.md)): Numbering style for this range
- `p` (`string`): Prefix string for this range
- `first` (`int`): First number appearing on a page in this range

Public constructor

## Properties

### EndPageIndex

```csharp
int Datalogics.PDFL.PageLabel.EndPageIndex { get; }
```

The zero-based ending page index for this page label range.

You cannot set the end index for a range; you must change the start index for the following range. A value of -1 means the end index for this PageLabel is unknown (e.g. when the label has not yet been added to a Document).

### FirstNumberInRange

```csharp
int Datalogics.PDFL.PageLabel.FirstNumberInRange { get; set; }
```

The first numeric value used for page labels in this range.

Must be greater than or equal to 1.

### NumberStyle

```csharp
NumberStyle Datalogics.PDFL.PageLabel.NumberStyle { get; set; }
```

The NumberStyle used for generating page labels in this range.

### Prefix

```csharp
string Datalogics.PDFL.PageLabel.Prefix { get; set; }
```

The prefix string prepended to page labels in this range.

For example, a prefix of "A-" with decimal numbering starting at 1 would produce labels "A-1", "A-2", "A-3", etc.

### StartPageIndex

```csharp
int Datalogics.PDFL.PageLabel.StartPageIndex { get; set; }
```

The zero-based starting page index for this page label range in the Document.

## Methods

### Dispose

```csharp
void Datalogics.PDFL.PageLabel.Dispose()
```

**Returns:** `void`

### ToString

```csharp
override string Datalogics.PDFL.PageLabel.ToString()
```

**Returns:** `override string`

A string describing this PageLabel.

Returns a string representation of this PageLabel.

The string includes the start page, end page, number style, prefix, and first page number of this label range.