Attachment Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет вложение в сообщение электронной почты.
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
- Наследование
Примеры
В следующем примере кода показано вложение файла в сообщение электронной почты.
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"[email protected]",L"[email protected]",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(
"[email protected]",
"[email protected]",
"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();
}
Комментарии
Класс Attachment используется с классом MailMessage . Все сообщения включают , Bodyкоторый содержит содержимое сообщения. В дополнение к тексту может потребоваться отправить дополнительные файлы. Они отправляются в виде вложений и представляются в виде Attachment экземпляров. Чтобы добавить вложение в сообщение электронной почты, добавьте его в коллекцию MailMessage.Attachments .
Содержимое Stringвложения может быть именем файла , Streamили . Вы можете указать содержимое во вложении с помощью любого конструктора Attachment .
Сведения о заголовке MIME Content-Type для вложения представлены свойством ContentType . Заголовок Content-Type указывает тип и подтип носителя, а также все связанные параметры. Используйте ContentType для получения экземпляра, связанного с вложением.
Заголовок MIME Content-Disposition представлен свойством ContentDisposition . Заголовок Content-Disposition указывает метки времени представления и файла для вложения. Заголовок Content-Disposition отправляется только в том случае, если вложением является файл. Используйте свойство , ContentDisposition чтобы получить экземпляр, связанный с вложением.
Заголовок MIME Content-Transfer-Encoding представлен свойством TransferEncoding .
Конструкторы
Attachment(Stream, ContentType) |
Инициализирует новый экземпляр класса Attachment с указанным потоком и типом содержимого. |
Attachment(Stream, String) |
Инициализирует новый экземпляр класса Attachment с указанными потоком и именем. |
Attachment(Stream, String, String) |
Инициализирует новый экземпляр класса Attachment с указанными потоком, именем и информацией о типе MIME. |
Attachment(String) |
Инициализирует новый экземпляр класса Attachment с указанной строкой содержимого. |
Attachment(String, ContentType) |
Инициализирует новый экземпляр класса Attachment с указанной строкой содержимого и ContentType. |
Attachment(String, String) |
Инициализирует новый экземпляр класса Attachment с указанной строкой содержимого и информацией о типе MIME. |
Свойства
ContentDisposition |
Возвращает расположение содержимого MIME для этого вложения. |
ContentId |
Возвращает или задает идентификатор содержимого MIME для этого вложения. (Унаследовано от AttachmentBase) |
ContentStream |
Возвращает поток содержимого данного вложения. (Унаследовано от AttachmentBase) |
ContentType |
Возвращает тип содержимого данного вложения. (Унаследовано от AttachmentBase) |
Name |
Возвращает или задает значение имени типа содержимого MIME, связанного с данным вложением. |
NameEncoding |
Указывает кодировку для AttachmentName. |
TransferEncoding |
Возвращает или задает кодировку данного вложения. (Унаследовано от AttachmentBase) |
Методы
CreateAttachmentFromString(String, ContentType) |
Создает почтовое вложение, используя содержимое указанной строки и заданный ContentType. |
CreateAttachmentFromString(String, String) |
Создает почтовое вложение, используя содержимое указанной строки и заданное имя типа содержимого MIME. |
CreateAttachmentFromString(String, String, Encoding, String) |
Создает почтовое вложение, используя содержимое указанной строки, заданное имя типа содержимого MIME, кодировку символов и информацию заголовка MIME для вложения. |
Dispose() |
Освобождает ресурсы, используемые объектом AttachmentBase. (Унаследовано от AttachmentBase) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом AttachmentBase, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от AttachmentBase) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |