Dart

Attach a File to an Email

Demonstrates the Chilkat Email.AddFileAttachment method, which attaches a file read from the filesystem. It returns the content type Chilkat assigned to the attachment (inferred from the file extension). This example attaches a PDF and prints its detected content type.

Background: Each attachment carries a Content-Type (MIME type) such as application/pdf or image/png that tells the receiving client how to handle it. Chilkat gets this from the file's extension. Because attachment bytes are binary, they are Base64-encoded for transport, which is handled automatically — you simply point AddFileAttachment at a path and the file is read, encoded, and packaged into the message.

Chilkat Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the AddFileAttachment method, which attaches a file read from the
  // filesystem.  It returns the content type Chilkat assigned to the attachment (based on
  // the file extension), or returns failure if the file could not be read.

  final email = CkEmail();
  email.subject = 'Email with a file attachment';
  email.body = 'Please see the attached file.';

  // Attach a file.  The return value is the auto-detected content type.
  final String contentType;
  try {
    contentType = email.addFileAttachment('qa_data/attachments/report.pdf');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Attached content type = $contentType');
  print('NumAttachments = ${email.numAttachments}');

  // Note: The path "qa_data/attachments/report.pdf" is a relative local filesystem path,
  // relative to the current working directory of the running application.
}