ContentDisposition.Inline ContentDisposition.Inline ContentDisposition.Inline ContentDisposition.Inline Property

Definition

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

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.

Applies to