Attachment Třída

Definice

Obor názvů:

System.Net.Mail

Sestavení:

System.Net.Mail.dll

Zdroj:

Attachment.cs

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

Object

AttachmentBase

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)