Attachment Třída

Definice

Představuje přílohu e-mailu.

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
Dědičnost
Attachment

Příklady

Následující příklad kódu ukazuje připojení souboru k e-mailové zprávě.

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 = L"data.xls";
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"Quarterly data report.",L"See the attached spreadsheet." );
   
   // Create  the file attachment for this email message.
   Attachment^ data = gcnew 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 = gcnew SmtpClient( server );
   
   // Add credentials if the SMTP server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   
   // Display the values in the ContentDisposition for the attachment.
   ContentDisposition^ cd = data->ContentDisposition;
   Console::WriteLine( L"Content disposition" );
   Console::WriteLine( cd );
   Console::WriteLine( L"File {0}", cd->FileName );
   Console::WriteLine( L"Size {0}", cd->Size );
   Console::WriteLine( L"Creation {0}", cd->CreationDate );
   Console::WriteLine( L"Modification {0}", cd->ModificationDate );
   Console::WriteLine( L"Read {0}", cd->ReadDate );
   Console::WriteLine( L"Inline {0}", cd->Inline );
   Console::WriteLine( L"Parameters: {0}", cd->Parameters->Count );
   IEnumerator^ myEnum1 = cd->Parameters->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DictionaryEntry^ d = safe_cast<DictionaryEntry^>(myEnum1->Current);
      Console::WriteLine( L"{0} = {1}", d->Key, d->Value );
   }

   data->~Attachment();
   client->~SmtpClient();
}
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();
}

Poznámky

Třída se Attachment používá s MailMessage třídou . Všechny zprávy obsahují Body, který obsahuje obsah zprávy. Kromě textu můžete chtít odeslat další soubory. Ty se odesílají jako přílohy a jsou reprezentované jako Attachment instance. Pokud chcete do e-mailové zprávy přidat přílohu MailMessage.Attachments , přidejte ji do kolekce.

Obsah přílohy může být String, Streamnebo název souboru. Obsah přílohy můžete zadat pomocí libovolného konstruktoru Attachment .

Informace záhlaví mime Content-Type pro přílohu jsou reprezentovány ContentType vlastností . Hlavička Content-Type určuje typ a podtyp média a všechny přidružené parametry. Slouží ContentType k získání instance přidružené k příloze.

Hlavička MIME Content-Disposition je reprezentována ContentDisposition vlastností . Hlavička Content-Disposition určuje časová razítka prezentace a souboru přílohy. Hlavička Content-Disposition je odeslána pouze v případě, že příloha je soubor. ContentDisposition Pomocí vlastnosti získejte instanci přidruženou k příloze.

Hlavička MIME Content-Transfer-Encoding je reprezentována TransferEncoding vlastností .

Konstruktory

Attachment(Stream, ContentType)

Inicializuje novou instanci Attachment třídy se zadaným datovým proudem a typem obsahu.

Attachment(Stream, String)

Inicializuje novou instanci Attachment třídy se zadaným datovým proudem a názvem.

Attachment(Stream, String, String)

Inicializuje novou instanci Attachment třídy se zadaným streamem, názvem a typem MIME.

Attachment(String)

Inicializuje novou instanci Attachment třídy se zadaným řetězcem obsahu.

Attachment(String, ContentType)

Inicializuje novou instanci Attachment třídy se zadaným řetězcem obsahu a ContentType.

Attachment(String, String)

Inicializuje novou instanci Attachment třídy se zadaným řetězcem obsahu a informacemi o typu MIME.

Vlastnosti

ContentDisposition

Získá dispozici obsahu MIME pro tuto přílohu.

ContentId

Získá nebo nastaví ID obsahu MIME pro tuto přílohu.

(Zděděno od AttachmentBase)
ContentStream

Získá datový proud obsahu této přílohy.

(Zděděno od AttachmentBase)
ContentType

Získá typ obsahu této přílohy.

(Zděděno od AttachmentBase)
Name

Získá nebo nastaví hodnotu názvu typu obsahu MIME v typu obsahu přidruženého k této příloze.

NameEncoding

Určuje kódování pro AttachmentName.

TransferEncoding

Získá nebo nastaví kódování této přílohy.

(Zděděno od AttachmentBase)

Metody

CreateAttachmentFromString(String, ContentType)

Vytvoří přílohu pošty pomocí obsahu ze zadaného řetězce a zadaného ContentTypeřetězce .

CreateAttachmentFromString(String, String)

Vytvoří přílohu e-mailu pomocí obsahu ze zadaného řetězce a zadaného názvu typu obsahu MIME.

CreateAttachmentFromString(String, String, Encoding, String)

Vytvoří přílohu pošty pomocí obsahu ze zadaného řetězce, názvu zadaného typu obsahu MIME, kódování znaků a informací záhlaví MIME přílohy.

Dispose()

Uvolní prostředky používané nástrojem AttachmentBase.

(Zděděno od AttachmentBase)
Dispose(Boolean)

Uvolní nespravované prostředky používané nástrojem AttachmentBase a volitelně uvolní spravované prostředky.

(Zděděno od AttachmentBase)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro