ContentDisposition.DispositionType Vlastnost

Definice

Obor názvů:

System.Net.Mime

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

ContentDisposition.cs

Získá nebo nastaví typ dispozice pro přílohu e-mailu.

public:
 property System::String ^ DispositionType { System::String ^ get(); void set(System::String ^ value); };

public string DispositionType { get; set; }

member this.DispositionType : string with get, set

Public Property DispositionType As String

Hodnota vlastnosti

String

A String , který obsahuje typ dispozice. Hodnota není omezena, ale obvykle je jednou z DispositionType hodnot.

Výjimky

ArgumentNullException

Hodnota zadaná pro operaci sady je null.

ArgumentException

Hodnota zadaná pro operaci množiny se rovná Empty ("").

Příklady

Následující příklad kódu ukazuje, jak nastavit hodnotu této vlastnosti.

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

Poznámky

Hodnotu DispositionType vlastnosti může používat software, který zobrazuje e-mail k určení správného způsobu, jak prezentovat přílohy e-mailu. Inline přílohy se obvykle zobrazí, když uživatel otevře e-mail. Attachment přílohy se obvykle neotevře, dokud uživatel neprovede nějakou akci, například kliknutím na ikonu, která představuje přílohu.

Hlavička Content-Disposition je popsaná v dokumentu RFC 2183, který je k dispozici na adrese https://www.ietf.org.