Dart

Change the Filename of an Attachment

Demonstrates the Chilkat Email.SetAttachmentFilename method, which changes the filename of the attachment at a given zero-based index. This example adds an attachment and renames it, printing the filename before and after.

Background: The attachment filename is what a recipient sees and what most clients suggest when saving the file. Renaming it is handy when the original name is unclear, unsafe, or generic — for example giving a machine-generated tmp12345 a meaningful name like invoice.pdf before sending.

Chilkat Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the SetAttachmentFilename method, which changes the filename of the
  // attachment at the given zero-based index.

  final email = CkEmail();
  email.subject = 'Set attachment filename';

  email.addStringAttachment('oldname.txt', 'Some notes.');
  print('Filename before: ${email.getAttachmentFilename(0)}');

  // Change the filename of the first attachment (index 0).
  try {
    email.setAttachmentFilename(0, 'newname.txt');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Filename after: ${email.getAttachmentFilename(0)}');
}