---
title: "PdfLinkAnnotation"
canonical_url: "https://www.nutrient.io/api/csharp/editors/pdf/annotations/pdf-link-annotation/"
md_url: "https://www.nutrient.io/api/csharp/editors/pdf/annotations/pdf-link-annotation.md"
last_updated: "2026-10-08T08:55:57.709Z"
description: "Represents a link annotation that can navigate to a destination or perform an action."
---

Represents a link annotation that can navigate to a destination or perform an action.

```csharp

using Nutrient;

```

**Inherits from:** [`PdfAnnotation`](/api/csharp/editors/pdf/annotations/pdf-annotation/)

The SDK creates this class through factory methods or other SDK objects.

## Properties

### DestinationPageIndex

```csharp

public int DestinationPageIndex { get; }

```

The destination page index (0-based) if this link has an internal page destination. Returns -1 if no page destination is found.

**Type:** `int`

### HighlightingMode

```csharp

public string HighlightingMode { get; }

```

The highlighting mode for the link.

**Type:** `string`

### URI

```csharp

public string URI { get; set; }

```

The URI for this link annotation. Setting a non-empty value creates a URI action; setting empty removes any existing action.

**Type:** `string`

## Methods

### SetDestination

```csharp

public void SetDestination(int pageNumber, float? x = null, float? y = null)

```

Sets the link destination to navigate to a specific page in the document.

**Parameters**

| Name         | Type     | Description                                                                               |
| ------------ | -------- | ----------------------------------------------------------------------------------------- |
| `pageNumber` | `int`    | The 1-based destination page number.                                                      |
| `x`          | `float?` | Optional X coordinate on the destination page. If null, the view scrolls to the top-left. |
| `y`          | `float?` | Optional Y coordinate on the destination page. If null, the view scrolls to the top-left. |

## Resource management

```csharp

public void Dispose()

```

`PdfLinkAnnotation` implements `IDisposable`. Call `Dispose()` or use a C# `using` declaration to release its native handle right away. If you don't, the handle is released when the object is garbage collected.

---

## Related pages

- [Annotations](/api/csharp/editors/pdf/annotations.md)
- [Pdf Annotation Collection](/api/csharp/editors/pdf/annotations/pdf-annotation-collection.md)
- [Pdf Annotation](/api/csharp/editors/pdf/annotations/pdf-annotation.md)
- [Pdf Circle Annotation](/api/csharp/editors/pdf/annotations/pdf-circle-annotation.md)
- [Pdf Free Text Annotation](/api/csharp/editors/pdf/annotations/pdf-free-text-annotation.md)
- [Pdf Highlight Annotation](/api/csharp/editors/pdf/annotations/pdf-highlight-annotation.md)
- [Pdf Line Annotation](/api/csharp/editors/pdf/annotations/pdf-line-annotation.md)
- [Pdf Markup Annotation](/api/csharp/editors/pdf/annotations/pdf-markup-annotation.md)
- [Pdf Redact Annotation](/api/csharp/editors/pdf/annotations/pdf-redact-annotation.md)
- [Pdf Shape Annotation](/api/csharp/editors/pdf/annotations/pdf-shape-annotation.md)
- [Pdf Square Annotation](/api/csharp/editors/pdf/annotations/pdf-square-annotation.md)
- [Pdf Squiggly Annotation](/api/csharp/editors/pdf/annotations/pdf-squiggly-annotation.md)
- [Pdf Stamp Annotation](/api/csharp/editors/pdf/annotations/pdf-stamp-annotation.md)
- [Pdf Strike Out Annotation](/api/csharp/editors/pdf/annotations/pdf-strike-out-annotation.md)
- [Pdf Text Annotation](/api/csharp/editors/pdf/annotations/pdf-text-annotation.md)
- [Pdf Underline Annotation](/api/csharp/editors/pdf/annotations/pdf-underline-annotation.md)
- [Pdf Widget Annotation](/api/csharp/editors/pdf/annotations/pdf-widget-annotation.md)