# SaveSettings.ImageSaveMode Property

> Determines whether the document's images are stored through its data or through its file reference. By default images are stored through a file reference, when a file reference exists. Otherwise, if an image has been pasted from the clipboard, it is stored with its binary data. For a single image the value of this property can be overwritten with the Image.SaveMode property. The technical article Loading and Saving Images gives an overview how to export images.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Reference
- **Kind:** Property
- **Introduced:** 15.1
- **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 > SaveSettings.ImageSaveMode Property
- **663 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/savesettings/imagesavemode-property/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/savesettings/imagesavemode-property/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/savesettings/imagesavemode-property/llms-full.txt

---

### Description

Determines whether the document's images are stored through its data or through its file reference. By default images are stored through a file reference, when a file reference exists. Otherwise, if an image has been pasted from the clipboard, it is stored with its binary data. For a single image the value of this property can be overwritten with the [Image.SaveMode](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/image/savemode-property/llms-full.txt) property. The technical article Loading and Saving Images gives an overview how to export images.

### Syntax

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

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

### Members

| Value | Description |
|---|---|
| Auto | An image is saved with a file reference, when a file reference exists. Otherwise it is saved with its binary data. |
| SaveAsData | The document's images are saved with their binary data. |
| SaveAsFileReference | The document's images are saved through file references. |

### Examples

The following example configures how the current document is exported to WordprocessingML by using `SaveSettings.ImageSaveMode`.

```csharp
textControl.Text = "Quarterly results";
SaveSettings saveSettings = new();

saveSettings.ImageSaveMode = ImageSaveMode.Auto;
Console.WriteLine($"Image Save Mode used by Save Settings: {saveSettings.ImageSaveMode}");

textControl.Save("quarterly-results.docx", StreamType.WordprocessingML, saveSettings);
```

```vbnet
textControl.Text = "Quarterly results"
Dim saveSettings As New SaveSettings()

saveSettings.ImageSaveMode = ImageSaveMode.Auto
Console.WriteLine($"Image Save Mode used by Save Settings: {saveSettings.ImageSaveMode}")

textControl.Save("quarterly-results.docx", StreamType.WordprocessingML, saveSettings)
```

---

## Nearby

- **Previous:** [SaveSettings.ImageMaxResolution Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/savesettings/imagemaxresolution-property/llms-full.txt)
- **Next:** [SaveSettings.ImageSavePath Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/savesettings/imagesavepath-property/llms-full.txt)