# SignatureImage.SaveMode Property

> Determines whether the image is stored through its data or through its file reference. By default an image is stored through a file reference if a file reference exists. Otherwise, if the image has been pasted from the clipboard or has been loaded from a data stream, it is stored with its complete binary data.

- **Product:** TX Text Control .NET for WPF
- **Section:** Reference
- **Kind:** Property
- **Introduced:** 31.0
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.WPF.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 WPF > Reference > TXTextControl > SignatureImage.SaveMode Property
- **782 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/signatureimage/savemode-property/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/signatureimage/savemode-property/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/signatureimage/savemode-property/llms-full.txt

---

### Description

Determines whether the image is stored through its data or through its file reference. By default an image is stored through a file reference if a file reference exists. Otherwise, if the image has been pasted from the clipboard or has been loaded from a data stream, it is stored with its complete binary data.

### Syntax

```csharp
public ImageSaveMode SaveMode { get; set; }
```

```vbnet
Public Property SaveMode As ImageSaveMode
```

### Members

| Value | Description |
|---|---|
| Auto | The image is saved as specified with the [SaveSettings.ImageSaveMode](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/savesettings/imagesavemode-property/llms-full.txt) property. |
| SaveAsData | The image is saved in a Text Control document with its complete binary data. |
| SaveAsFileReference | The image is saved in a Text Control document through a file reference. |

### Examples

The following example adds a visible handwritten-signature image to an approval field by using `SignatureImage.SaveMode`.

```csharp
SignatureImage signatureImage = new(@"Images\alex-smith-signature.svg", 0);
SignatureField approval = new(new System.Drawing.Size(3000, 1000), "ApproverSignature", 10) { Image = signatureImage };
textControl.SignatureFields.Add(approval, FrameInsertionMode.AsCharacter);

signatureImage.SaveMode = ImageSaveMode.Auto;
Console.WriteLine($"Save Mode used by Signature Image: {signatureImage.SaveMode}");
```

```vbnet
Dim signatureImage As New SignatureImage("Images\alex-smith-signature.svg", 0)
Dim approval As New SignatureField(New System.Drawing.Size(3000, 1000), "ApproverSignature", 10) With { .Image = signatureImage }
textControl.SignatureFields.Add(approval, FrameInsertionMode.AsCharacter)

signatureImage.SaveMode = ImageSaveMode.Auto
Console.WriteLine($"Save Mode used by Signature Image: {signatureImage.SaveMode}")
```

---

## Nearby

- **Previous:** [SignatureImage.FilterIndex Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/signatureimage/filterindex-property/llms-full.txt)
- **Next:** [SignerData Class](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/signerdata/llms-full.txt)