ContentDisposition Classe

Definição

Namespace:

System.Net.Mime

Assembly:

System.Net.Mail.dll

Origem:

ContentDisposition.cs

Representa um cabeçalho de Disposição do Conteúdo 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.

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

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 em ContentDisposition podem ser usadas pelo software que exibe o email para apresentar os anexos de email da maneira pretendida pelo remetente.

Email mensagens 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 para um 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 do 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 em RFC 2183 disponível em https://www.ietf.org.

Construtores

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

Propriedades

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 de arquivo sugerido para um anexo de email.
Inline	Obtém ou define um valor Boolean que determina o tipo de disposição (Embutido ou Anexo) de 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

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