ContentDisposition Classe

Definição

Namespace:

System.Net.Mime

Assemblies:

netstandard.dll, System.Net.Mail.dll

Origem:

ContentDisposition.cs

Representa um cabeçalho Content-Disposition do protocolo MIME.

public ref class ContentDisposition

public class ContentDisposition

type ContentDisposition = class

Public Class ContentDisposition

Herança

Object

ContentDisposition

Exemplos

O exemplo de código a seguir cria uma mensagem de email com um anexo a ser exibido embutido.

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

Comentários

As informações na ContentDisposition classe acompanham uma mensagem de email que contém anexos quando a mensagem de email é enviada para seu destino. As informações podem ContentDisposition ser usadas pelo software que exibe email para apresentar os anexos de email da maneira pretendida pelo remetente.

As mensagens de email são criadas usando instâncias da MailMessage classe. Instâncias da Attachment classe são usadas para adicionar anexos a mensagens de email. Para modificar o ContentDisposition anexo, obtenha a instância da Attachment.ContentDisposition propriedade.

O conteúdo a ser exibido como parte do corpo da mensagem tem o tipo de disposição .Inline O conteúdo que não é exibido, mas é anexado em um arquivo separado, tem o tipo de disposição .Attachment Use a Inline propriedade para controlar o tipo de disposição do anexo associado a uma instância de ContentDisposition.

Para anexos de arquivo, você pode usar as propriedades do ContentDisposition para definir o tamanho do arquivo, bem como a data em que o arquivo foi criado, a última leitura e a última modificação. Para todos os anexos, você pode definir um nome de arquivo recomendado caso o anexo seja armazenado no computador receptor.

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

Construtores

Nome	Description
ContentDisposition()	Inicializa uma nova instância da ContentDisposition classe com um DispositionType de Attachment.
ContentDisposition(String)	Inicializa uma nova instância da ContentDisposition classe com as informações de disposição especificadas.

Propriedades

Nome	Description
CreationDate	Obtém ou define a data de criação de um anexo de arquivo.
DispositionType	Obtém ou define o tipo de disposição de um anexo de email.
FileName	Obtém ou define o nome do arquivo sugerido para um anexo de email.
Inline	Obtém ou define um Boolean valor que determina o tipo de disposição (embutido ou anexo) para um anexo de email.
ModificationDate	Obtém ou define a data de modificação de um anexo de arquivo.
Parameters	Obtém os parâmetros incluídos no cabeçalho Content-Disposition representado por essa instância.
ReadDate	Obtém ou define a data de leitura de um anexo de arquivo.
Size	Obtém ou define o tamanho de um anexo de arquivo.

Métodos

Nome	Description
Equals(Object)	Determina se o cabeçalho de disposição de conteúdo do objeto especificado ContentDisposition é igual ao cabeçalho de disposição de conteúdo deste objeto.
GetHashCode()	Determina o código hash do objeto especificado ContentDisposition .
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma String representação dessa instância.