Attachment Constructor (String, String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the Attachment class with the specified content string and MIME type information.

Namespace:   System.Net.Mail
Assembly:  System (in System.dll)

public Attachment(
	string fileName,
	string mediaType


Type: System.String

A String that contains the content for this attachment.

Type: System.String

A String that contains the MIME Content-Header information for this attachment. This value can be null.

Exception Condition

fileName is null.


mediaType is not in the correct format.

If mediaType is null or equal to String.Empty (""), the MediaType property for this attachment is set to Plain. If mediaType is not null and is not a zero-length string, it is used to construct the ContentType associated with this attachment.

The following code example demonstrates how to call this constructor.

public static void CreateMessageInlineAttachment(string server, string
	// Create a message and set up the recipients.
	MailMessage message = new MailMessage(
	   "An inline text message for you.",
	   "Message: ");

	// Attach the message string to this e-mail message.
	Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
	// Send textMessage as part of the e-mail body.
	ContentDisposition disposition = data.ContentDisposition;
	disposition.Inline = true;
	//Send the message.
	// Include credentials if the server requires them.
	SmtpClient client = new SmtpClient(server);
	client.Credentials = CredentialCache.DefaultNetworkCredentials;

   try {
    catch (Exception ex) {
      Console.WriteLine("Exception caught in CreateMessageInlineAttachment: {0}", 
                  ex.ToString() );

.NET Framework
Available since 2.0
Return to top