ContentDisposition.DispositionType Propriété

Définition

Espace de noms:

System.Net.Mime

Assemblys:

netstandard.dll, System.Net.Mail.dll

Source:

ContentDisposition.cs

Obtient ou définit le type de disposition d’une pièce jointe.

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

Valeur de propriété

String

Qui String contient le type de disposition. La valeur n’est pas limitée, mais elle est généralement l’une des DispositionType valeurs.

Exceptions

ArgumentNullException

La valeur spécifiée pour une opération set est null.

ArgumentException

La valeur spécifiée pour une opération de jeu est égale à Empty ( » « ).

Exemples

L’exemple de code suivant montre comment définir la valeur de cette propriété.

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

Remarques

La DispositionType valeur de propriété peut être utilisée par les logiciels qui affichent l’e-mail pour déterminer la façon appropriée de présenter les pièces jointes de l’e-mail. Inline Les pièces jointes sont généralement affichées lorsque l’utilisateur ouvre l’e-mail. Attachment Les pièces jointes ne sont généralement pas ouvertes tant que l’utilisateur n’a pas effectué une action, par exemple en cliquant sur une icône qui représente la pièce jointe.

L’en-tête Content-Disposition est décrit dans RFC 2183 disponible à l’adresse https://www.ietf.org.