# DocumentSettings.EmbeddedFiles Property

> Gets or sets an array of EmbeddedFile objects providing the name, data and additional optional properties of files, which are embedded in the current document. The property value is null, if there are no embedded files contained in the document.

- **Product:** TX Text Control .NET Server
- **Section:** Reference
- **Kind:** Property
- **Introduced:** 29.0
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.Core.SDK` (assembly `TXTextControl.Core.dll`, from the private NuGet feed or Text Control Offline Packages)
- **Package:** `TXTextControl.TextControl.ASP.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 Server > Reference > TXTextControl > DocumentSettings.EmbeddedFiles Property
- **735 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/documentsettings/embeddedfiles-property/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/documentsettings/embeddedfiles-property/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/documentsettings/embeddedfiles-property/llms-full.txt

---

### Description

Gets or sets an array of [EmbeddedFile](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/embeddedfile/llms-full.txt) objects providing the name, data and additional optional properties of files, which are embedded in the current document. The property value is null, if there are no embedded files contained in the document.

### Syntax

```csharp
public EmbeddedFile[] EmbeddedFiles { get; set; }
```

```vbnet
Public Property EmbeddedFiles As EmbeddedFile()
```

### Examples

The following example configures document settings for the current document by using `DocumentSettings.EmbeddedFiles`.

```csharp
DocumentSettings documentSettings = textControl.DocumentSettings;

documentSettings.EmbeddedFiles = new EmbeddedFile[] { new EmbeddedFile("document.docx", new Microsoft.Win32.SafeHandles.SafeFileHandle(IntPtr.Zero, ownsHandle: false), "Quarterly report") };
if (documentSettings.EmbeddedFiles != null)
{
    Console.WriteLine("Document Settings: Embedded Files is available.");
}

documentSettings.DocumentTitle = "Quarterly results";
documentSettings.Author = "Finance team";
```

```vbnet
Dim documentSettings As DocumentSettings = textControl.DocumentSettings

documentSettings.EmbeddedFiles = New EmbeddedFile() { New EmbeddedFile("document.docx", New Microsoft.Win32.SafeHandles.SafeFileHandle(IntPtr.Zero, ownsHandle:=False), "Quarterly report") }
If documentSettings.EmbeddedFiles IsNot Nothing Then
    Console.WriteLine("Document Settings: Embedded Files is available.")
End If

documentSettings.DocumentTitle = "Quarterly results"
documentSettings.Author = "Finance team"
```

### Limitations

PDF and PDF/A only.

---

## Nearby

- **Previous:** [DocumentSettings.DocumentTitle Property](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/documentsettings/documenttitle-property/llms-full.txt)
- **Next:** [DocumentSettings.UserDefinedDocumentProperties Property](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/documentsettings/userdefineddocumentproperties-property/llms-full.txt)