ContentDisposition.Inline Property

Definition

Namespace:

System.Net.Mime

Assembly:

System.Net.Mail.dll

Source:

ContentDisposition.cs

Gets or sets a Boolean value that determines the disposition type (Inline or Attachment) for an email attachment.

public:
 property bool Inline { bool get(); void set(bool value); };

public bool Inline { get; set; }

member this.Inline : bool with get, set

Public Property Inline As Boolean

Property Value

Boolean

true if content in the attachment is presented inline as part of the email body; otherwise, false.

Examples

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

static void CreateMessageInlineAttachment( String^ server, String^ textMessage )
{
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"An inline text message for you.",L"Message: " );
   
   // Attach the message string to this email message.
   Attachment^ data = gcnew Attachment( textMessage,MediaTypeNames::Text::Plain );
   
   // Send textMessage as part of the email body.
   message->Attachments->Add( data );
   ContentDisposition^ disposition = data->ContentDisposition;
   disposition->Inline = true;
   
   //Send the message.
   // Include credentials if the server requires them.
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
}

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

    // Attach the message string to this email message.
    Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
    // Send textMessage as part of the email body.
    message.Attachments.Add(data);
    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
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateMessageInlineAttachment: {0}",
            ex.ToString());
    }
    data.Dispose();
}

Remarks

The Inline property sets the disposition type in the Content-Disposition header sent with the email message. The disposition type can be used by software that displays email to determine the correct way to present the email attachments. Attachments with a disposition type of DispositionTypeNames.Inline are usually displayed when the user opens the email. Attachments with a disposition type of DispositionTypeNames.Attachment are usually not opened until the user performs some additional 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.