ContentDisposition.Inline Eigenschaft

Definition

Namespace:

System.Net.Mime

Assembly:

System.Net.Mail.dll

Quelle:

ContentDisposition.cs

Ruft einen Boolean-Wert ab, der den Dispositionstyp („Inline“ oder „Attachment“) für eine E-Mail-Anlage bestimmt, oder legt diesen Wert fest.

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

Eigenschaftswert

Boolean

true , wenn Inhalte in der Anlage als Teil des E-Mail-Texts inline angezeigt werden; falseandernfalls .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Wert dieser Eigenschaft festgelegt wird.

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

Hinweise

Die Inline -Eigenschaft legt den Dispositionstyp im Content-Disposition-Header fest, der mit der E-Mail-Nachricht gesendet wird. Der Dispositionstyp kann von Software verwendet werden, die E-Mails anzeigt, um die richtige Art und Weise zu bestimmen, wie die E-Mail-Anlagen angezeigt werden. Anlagen mit einem Dispositionstyp von DispositionTypeNames.Inline werden normalerweise angezeigt, wenn der Benutzer die E-Mail öffnet. Anlagen mit einem Dispositionstyp von DispositionTypeNames.Attachment werden normalerweise erst geöffnet, wenn der Benutzer eine zusätzliche Aktion ausführt, z. B. das Klicken auf ein Symbol, das die Anlage darstellt.

Der Content-Disposition-Header wird in RFC 2183 beschrieben, das unter https://www.ietf.orgverfügbar ist.