ContentDisposition Classe

Definizione

Spazio dei nomi:

System.Net.Mime

Assembly:

System.Net.Mail.dll

Origine:

ContentDisposition.cs

Rappresenta un'intestazione Content-Disposition di protocollo MIME.

public ref class ContentDisposition

public class ContentDisposition

type ContentDisposition = class

Public Class ContentDisposition

Ereditarietà

Object

ContentDisposition

Esempio

Nell'esempio di codice seguente viene creato un messaggio di posta elettronica con un allegato da visualizzare inline.

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

Commenti

Le informazioni nella ContentDisposition classe accompagnano un messaggio di posta elettronica contenente allegati quando il messaggio di posta elettronica viene inviato alla destinazione. Le informazioni contenute in ContentDisposition possono essere usate dal software che visualizza la posta elettronica per presentare gli allegati di posta elettronica nel modo previsto dal mittente.

Email messaggi vengono creati usando istanze della MailMessage classe. Le istanze della Attachment classe vengono usate per aggiungere allegati ai messaggi di posta elettronica. Per modificare l'oggetto ContentDisposition per un allegato, ottenere l'istanza dalla Attachment.ContentDisposition proprietà .

Il contenuto da visualizzare come parte del corpo del messaggio ha il tipo di eliminazione di Inline. Contenuto non visualizzato ma collegato in un file separato ha il tipo di eliminazione di Attachment. Utilizzare la Inline proprietà per controllare il tipo di eliminazione per l'allegato associato a un'istanza di ContentDisposition.

Per gli allegati di file, è possibile usare le proprietà dell'oggetto ContentDisposition per impostare le dimensioni del file, nonché la data di creazione del file, l'ultima lettura e l'ultima modifica. Per tutti gli allegati, è possibile impostare un nome di file consigliato nel caso in cui l'allegato venga archiviato nel computer ricevente.

Il ToString metodo restituisce l'intestazione Content-Disposition. L'intestazione Content-Disposition è descritta in RFC 2183 disponibile in https://www.ietf.org.

Costruttori

ContentDisposition()	Inizializza una nuova istanza della classe ContentDisposition con la proprietà DispositionType impostata su Attachment.
ContentDisposition(String)	Inizializza una nuova istanza della classe ContentDisposition utilizzando le informazioni di disposizione specificate.

Proprietà

CreationDate	Ottiene o imposta la data di creazione per un allegato incluso in un file.
DispositionType	Ottiene o imposta il tipo di disposizione per un allegato di posta elettronica.
FileName	Ottiene o imposta il nome suggerito per il file di un allegato di posta elettronica.
Inline	Ottiene o imposta un valore Boolean che determina il tipo di disposizione (Inline o Attachment) per un allegato di posta elettronica.
ModificationDate	Ottiene o imposta la data di modifica per un allegato incluso in un file.
Parameters	Ottiene i parametri inclusi nell'intestazione Content-Disposition rappresentata da questa istanza.
ReadDate	Ottiene o imposta la data di lettura per un allegato incluso in un file.
Size	Ottiene o imposta la dimensione di un allegato incluso in un file.

Metodi

Equals(Object)	Determina se l'intestazione Content-Disposition dell'oggetto ContentDisposition specificato corrisponde all'intestazione Content-Disposition di questo oggetto.
GetHashCode()	Determina il codice hash dell'oggetto ContentDisposition specificato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una rappresentazione String di questa istanza.