Attachment Classe

Definizione

Spazio dei nomi:

System.Net.Mail

Assembly:

netstandard.dll, System.Net.Mail.dll

Origine:

Attachment.cs

Rappresenta un allegato a un messaggio di posta elettronica.

public ref class Attachment : System::Net::Mail::AttachmentBase

public class Attachment : System.Net.Mail.AttachmentBase

type Attachment = class
    inherit AttachmentBase

Public Class Attachment
Inherits AttachmentBase

Ereditarietà

Object

AttachmentBase

Attachment

Esempio

Nell'esempio di codice seguente viene illustrato come allegare un file a un messaggio di posta elettronica.

public static void CreateMessageWithAttachment(string server)
{
    // Specify the file to be attached and sent.
    // This example assumes that a file named Data.xls exists in the
    // current working directory.
    string file = "data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
        "jane@contoso.com",
        "ben@contoso.com",
        "Quarterly data report.",
        "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment(file, 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);
    // 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 = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateMessageWithAttachment(): {0}",
            ex.ToString());
    }
    // Display the values in the ContentDisposition for the attachment.
    ContentDisposition cd = data.ContentDisposition;
    Console.WriteLine("Content disposition");
    Console.WriteLine(cd.ToString());
    Console.WriteLine("File {0}", cd.FileName);
    Console.WriteLine("Size {0}", cd.Size);
    Console.WriteLine("Creation {0}", cd.CreationDate);
    Console.WriteLine("Modification {0}", cd.ModificationDate);
    Console.WriteLine("Read {0}", cd.ReadDate);
    Console.WriteLine("Inline {0}", cd.Inline);
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count);
    foreach (DictionaryEntry d in cd.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    data.Dispose();
}

Commenti

La Attachment classe viene usata con la MailMessage classe . Tutti i messaggi includono , Bodyche contiene il contenuto del messaggio. Oltre al corpo, è possibile inviare file aggiuntivi. Questi vengono inviati come allegati e sono rappresentati come Attachment istanze. Per aggiungere un allegato a un messaggio di posta elettronica, aggiungerlo alla MailMessage.Attachments raccolta.

Il contenuto degli allegati può essere un Stringnome di file , Streamo . È possibile specificare il contenuto in un allegato usando uno dei Attachment costruttori.

Le informazioni sull'intestazione MIME Content-Type per l'allegato sono rappresentate dalla ContentType proprietà . L'intestazione Content-Type specifica il tipo di supporto e il sottotipo e tutti i parametri associati. Usare ContentType per ottenere l'istanza associata a un allegato.

L'intestazione MIME Content-Disposition è rappresentata dalla ContentDisposition proprietà . L'intestazione Content-Disposition specifica i timestamp di presentazione e file per un allegato. Un'intestazione Content-Disposition viene inviata solo se l'allegato è un file. Utilizzare la ContentDisposition proprietà per ottenere l'istanza associata a un allegato.

L'intestazione MIME Content-Transfer-Encoding è rappresentata dalla TransferEncoding proprietà .

Costruttori

Nome	Descrizione
Attachment(Stream, ContentType)	Inizializza una nuova istanza della Attachment classe con il flusso e il tipo di contenuto specificati.
Attachment(Stream, String, String)	Inizializza una nuova istanza della Attachment classe con il flusso, il nome e le informazioni sul tipo MIME specificati.
Attachment(Stream, String)	Inizializza una nuova istanza della Attachment classe con il flusso e il nome specificati.
Attachment(String, ContentType)	Inizializza una nuova istanza della Attachment classe con la stringa di contenuto specificata e ContentType.
Attachment(String, String)	Inizializza una nuova istanza della Attachment classe con la stringa di contenuto e le informazioni sul tipo MIME specificate.
Attachment(String)	Inizializza una nuova istanza della Attachment classe con la stringa di contenuto specificata.

Proprietà

Nome	Descrizione
ContentDisposition	Ottiene l'eliminazione del contenuto MIME per questo allegato.
ContentId	Ottiene o imposta l'ID contenuto MIME per questo allegato. (Ereditato da AttachmentBase)
ContentStream	Ottiene il flusso di contenuto dell'allegato. (Ereditato da AttachmentBase)
ContentType	Ottiene il tipo di contenuto dell'allegato. (Ereditato da AttachmentBase)
Name	Ottiene o imposta il valore del nome del tipo di contenuto MIME nel tipo di contenuto associato all'allegato.
NameEncoding	Specifica la codifica per .AttachmentName
TransferEncoding	Ottiene o imposta la codifica dell'allegato. (Ereditato da AttachmentBase)

Metodi

Nome	Descrizione
CreateAttachmentFromString(String, ContentType)	Crea un allegato di posta utilizzando il contenuto della stringa specificata e l'oggetto specificato ContentType.
CreateAttachmentFromString(String, String, Encoding, String)	Crea un allegato di posta utilizzando il contenuto della stringa specificata, il nome del tipo di contenuto MIME specificato, la codifica dei caratteri e le informazioni sull'intestazione MIME per l'allegato.
CreateAttachmentFromString(String, String)	Crea un allegato di posta utilizzando il contenuto della stringa specificata e il nome del tipo di contenuto MIME specificato.
Dispose()	Rilascia le risorse usate da AttachmentBase. (Ereditato da AttachmentBase)
Dispose(Boolean)	Rilascia le risorse non gestite usate da AttachmentBase e, facoltativamente, rilascia le risorse gestite. (Ereditato da AttachmentBase)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)