ContentDisposition.DispositionType Property

Definition

Namespace:

System.Net.Mime

Assemblies:

netstandard.dll, System.Net.Mail.dll

Source:

ContentDisposition.cs

Gets or sets the disposition type for an email attachment.

C#

public string DispositionType { get; set; }

Property Value

String

A String that contains the disposition type. The value is not restricted but is typically one of the DispositionType values.

Exceptions

ArgumentNullException

The value specified for a set operation is null.

ArgumentException

The value specified for a set operation is equal to Empty ("").

Examples

The following code example demonstrates how to set the value of this property.

C#

public static void CreateMessageWithAttachment4(string server, string to)
{
    // Specify the file to be attached and sent.
    // This example uses a file on a UNC share.
    string file = @"\\share3\c$\reports\data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "ReportMailer@contoso.com",
       to,
       "Quarterly data report",
       "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment("qtr3.xls", MediaTypeNames.Application.Octet);
    // Add time stamp information for the file.
    ContentDisposition disposition = data.ContentDisposition;
    disposition.CreationDate = System.IO.File.GetCreationTime(file);
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
    disposition.DispositionType = DispositionTypeNames.Attachment;
    // Add the file attachment to this email message.
    message.Attachments.Add(data);
    //Send the message.
    SmtpClient client = new SmtpClient(server);
    // Add credentials if the SMTP server requires them.
    client.Credentials = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the message headers.
    string[] keys = message.Headers.AllKeys;
    Console.WriteLine("Headers");
    foreach (string s in keys)
    {
        Console.WriteLine("{0}:", s);
        Console.WriteLine("    {0}", message.Headers[s]);
    }
    data.Dispose();
}

Remarks

The DispositionType property value can be used by software that displays email to determine the correct way to present the email attachments. Inline attachments are usually displayed when the user opens the email. Attachment attachments are usually not opened until the user performs some action, such as clicking an icon that represents the attachment.

The Content-Disposition header is described in RFC 2183 available at https://www.ietf.org.

Applies to