AttachmentCollection

.NET Framework クラス ライブラリ リファレンス

AttachmentCollection クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

電子メール メッセージの一部として送信される添付データを格納します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 AttachmentCollection
    Inherits Collection(Of Attachment)
    Implements IDisposable

Visual Basic (使用法)

Dim instance As AttachmentCollection

C#

public sealed class AttachmentCollection :
 Collection<Attachment>, IDisposable

C++

public ref class AttachmentCollection sealed
 : public Collection<Attachment^>, IDisposable

J#

public final class AttachmentCollection extends
 Collection<Attachment> implements IDisposable

JScript

public final class AttachmentCollection extends
 Collection<Attachment> implements IDisposable

解説

AttachmentCollection クラスのインスタンスは、MailMessage.AlternateViews プロパティおよび MailMessage.Attachments プロパティによって返されます。

AlternateViews プロパティを使用して、別の形式で電子メール メッセージのコピーを指定します。たとえば、HTML 形式でメッセージを送信する場合に、一部の受信者が HTML コンテンツを表示できない電子メール プログラムを使用している場合は、プレーン テキスト版も提供できます。

Attachments プロパティによって返されるコレクションを使用して、ファイルや Stream の内容などの添付データをこの MailMessage に追加します。

使用例

添付ファイルの付いた電子メール メッセージの作成および送信を行う方法を次のコード例に示します。

C#

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 e-mail 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 e-mail 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;
    client.Send(message);
    // 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();
}

継承階層

System.Object
   System.Collections.ObjectModel.Collection
    System.Net.Mail.AttachmentCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
AttachmentCollection メンバ
System.Net.Mail 名前空間
SmtpClient

AttachmentCollection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	Collection に実際に格納されている要素の数を取得します。 ( Collection から継承されます。)
	Item	指定したインデックスにある要素を取得または設定します。 ( Collection から継承されます。)

プロテクト プロパティ

	名前	説明
	Items	Collection をラップする List ラッパーを取得します。 ( Collection から継承されます。)

参照

関連項目

AttachmentCollection クラス
System.Net.Mail 名前空間
SmtpClient

AttachmentCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	Collection の末尾にオブジェクトを追加します。 ( Collection から継承されます。)
	Clear	Collection からすべての要素を削除します。 ( Collection から継承されます。)
	Contains	ある要素が Collection 内に存在するかどうかを判断します。 ( Collection から継承されます。)
	CopyTo	Collection 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 ( Collection から継承されます。)
	Dispose	AttachmentCollection によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	Collection を反復処理する列挙子を返します。 ( Collection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	指定したオブジェクトを検索し、Collection 全体内で最初に見つかった位置の 0 から始まるインデックスを返します。 ( Collection から継承されます。)
	Insert	Collection 内の指定したインデックスの位置に要素を挿入します。 ( Collection から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	Collection 内で最初に見つかった特定のオブジェクトを削除します。 ( Collection から継承されます。)
	RemoveAt	Collection の指定したインデックスにある要素を削除します。 ( Collection から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	ClearItems	Collection からすべての要素を削除します。 ( Collection から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	InsertItem	Collection 内の指定したインデックスの位置に要素を挿入します。 ( Collection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	RemoveItem	Collection の指定したインデックスにある要素を削除します。 ( Collection から継承されます。)
	SetItem	指定したインデックス位置にある要素を置き換えます。 ( Collection から継承されます。)

参照

関連項目

AttachmentCollection クラス
System.Net.Mail 名前空間
SmtpClient

AttachmentCollection メンバ

電子メール メッセージの一部として送信される添付データを格納します。

AttachmentCollection データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	Collection に実際に格納されている要素の数を取得します。(Collection から継承されます。)
	Item	指定したインデックスにある要素を取得または設定します。(Collection から継承されます。)

プロテクト プロパティ

	名前	説明
	Items	Collection をラップする List ラッパーを取得します。(Collection から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	Collection の末尾にオブジェクトを追加します。 (Collection から継承されます。)
	Clear	Collection からすべての要素を削除します。 (Collection から継承されます。)
	Contains	ある要素が Collection 内に存在するかどうかを判断します。 (Collection から継承されます。)
	CopyTo	Collection 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 (Collection から継承されます。)
	Dispose	AttachmentCollection によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	Collection を反復処理する列挙子を返します。 (Collection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	指定したオブジェクトを検索し、Collection 全体内で最初に見つかった位置の 0 から始まるインデックスを返します。 (Collection から継承されます。)
	Insert	Collection 内の指定したインデックスの位置に要素を挿入します。 (Collection から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	Collection 内で最初に見つかった特定のオブジェクトを削除します。 (Collection から継承されます。)
	RemoveAt	Collection の指定したインデックスにある要素を削除します。 (Collection から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	ClearItems	Collection からすべての要素を削除します。 (Collection から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	InsertItem	Collection 内の指定したインデックスの位置に要素を挿入します。 (Collection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	RemoveItem	Collection の指定したインデックスにある要素を削除します。 (Collection から継承されます。)
	SetItem	指定したインデックス位置にある要素を置き換えます。 (Collection から継承されます。)

参照

関連項目

AttachmentCollection クラス
System.Net.Mail 名前空間
SmtpClient