Compartilhar via


ContentDisposition.DispositionType Propriedade

Definição

Obtém ou define o tipo de disposição de um anexo de email.

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

Valor da propriedade

Um String que contém o tipo de disposição. O valor não é restrito, mas normalmente é um dos DispositionType valores.

Exceções

O valor especificado para uma operação de conjunto é null.

O valor especificado para uma operação de conjunto é igual a Empty ("").

Exemplos

O exemplo de código a seguir demonstra como definir o valor dessa propriedade.

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

Comentários

O valor da DispositionType propriedade pode ser usado pelo software que exibe o email para determinar a maneira correta de apresentar os anexos de email. Inline Os anexos geralmente são exibidos quando o usuário abre o email. Attachment Os anexos geralmente não são abertos até que o usuário execute alguma ação, como clicar em um ícone que representa o anexo.

O cabeçalho Content-Disposition é descrito no RFC 2183 disponível em https://www.ietf.org.

Aplica-se a