ContentDisposition.Inline Właściwość

Definicja

Przestrzeń nazw:

System.Net.Mime

Zestaw:

System.Net.Mail.dll

Źródło:

ContentDisposition.cs

Pobiera lub ustawia wartość określającą Boolean typ dyspozycji (wbudowany lub załącznik) dla załącznika wiadomości e-mail.

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

Wartość właściwości

Boolean

true jeśli zawartość w załączniku jest wyświetlana w tekście w ramach treści wiadomości e-mail; w przeciwnym razie , false.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić wartość tej właściwości.

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();
}

Uwagi

Właściwość Inline ustawia typ dyspozycji w nagłówku Content-Disposition wysyłanym z wiadomością e-mail. Typ dyspozycji może być używany przez oprogramowanie, które wyświetla wiadomość e-mail w celu określenia prawidłowego sposobu prezentowania załączników wiadomości e-mail. Załączniki z typem dyspozycji DispositionTypeNames.Inline są zwykle wyświetlane po otwarciu wiadomości e-mail przez użytkownika. Załączniki o typie dyspozycji zwykle nie są otwierane, dopóki użytkownik nie wykona dodatkowej DispositionTypeNames.Attachment akcji, takiej jak kliknięcie ikony reprezentującej załącznik.

Nagłówek Content-Disposition został opisany w artykule RFC 2183 dostępnym pod adresem https://www.ietf.org.