Name プロパティ (Mailbox)

メールボックスの省略名（親メールボックス名を含まない名前）を取得または設定します。

シンタックス

Visual Basic (宣言)
C#

public string Name {get; set;}

Public Property Name As String

プロパティ値

メールボックスの省略名を表す文字列。

解説

たとえば、メールボックスの名前が次のような場合、

"inbox\archives\user"

Mailboxの名前に関連するプロパティは以下のようになります。

プロパティ	値
Mailbox.Name	"user"
Mailbox.FullName	"inbox\archives\user"

このプロパティを設定すると、RENAMEコマンドがサーバーに送信されます。これは省略名を変更するだけですが、いくつかの制限があります。たとえば、次のメールボックス名を

"company/users/bob"

次のように変更するには、

"company/users/bobjohnson"

Mailbox.Nameを"bobjohnson"に設定します。それに対して、次のメールボックス名を

"company/users/bob"

次のように変更するには、

"archive/bobbackup"

FullNameを"archive/bobbackup"に設定します。

"&"は、送信時に"&-"として表されます。"&"と"-"の間にあるものはすべてUnicodeに変換されます。

このプロパティを設定すると、SelectedMailboxがnullに設定され、選択中のメールボックスが閉じます。

使用例

以下のサンプルコードは、メールボックスを作成、名前変更、および削除する方法を示します。また、メールボックスの購読を開始および停止する方法も示します。

private void doMailboxFunctions(object sender)
{
    // サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = new Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session));
    imap1.Session.Username = myUsername;
    imap1.Session.Password = myPassword;

    // 接続してアカウントにログインします。
    imap1.Connect();
    imap1.Authenticate();

    // メールボックスを作成します。
    Mailbox newBox = imap1.Mailboxes.Add("My_New_Box");

    // メールボックスの購読を開始し、購読リストをチェックします。
    newBox.Subscribe();
    // 購読しているすべてのメールボックスを取得します。
    List<Mailbox> list = imap1.List("", "%", true).ToList<Mailbox>();
    if (!list.Contains(newBox)) throw new Exception("Server did not subscribe the mailbox.");

    // メールボックスの購読を停止し、購読リストをチェックします。
    newBox.Unsubscribe();
    list = imap1.List("", "%", true).ToList<Mailbox>();
    if (list.Contains(newBox)) throw new Exception("Server did not unsubscribe the mailbox.");

    // メールボックスの名前を変更してから、メールボックスを削除します。
    newBox.Name = newBox.Name + "_Renamed";
    imap1.Mailboxes.Remove(newBox);

    // セッションから適切にログアウトします。
    imap1.Close();
}

Visual Basic

Private Sub doMailboxFunctions(ByVal sender As Object)
    ' サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = New Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session))
    imap1.Session.Username = myUsername
    imap1.Session.Password = myPassword

    ' 接続してアカウントにログインします。
    imap1.Connect()
    imap1.Authenticate()

    ' メールボックスを作成します。
    Dim newBox As Mailbox = imap1.Mailboxes.Add("My_New_Box")

    ' メールボックスの購読を開始し、購読リストをチェックします。
    newBox.Subscribe()
    ' 購読しているすべてのメールボックスを取得します。
    Dim list As List(Of Mailbox) = imap1.List("", "%", True).ToList()
    If Not list.Contains(newBox) Then
        Throw New Exception("Server did not subscribe the mailbox.")
    End If

    ' メールボックスの購読を停止し、購読リストをチェックします。
    newBox.Unsubscribe()
    list = imap1.List("", "%", True).ToList()
    If list.Contains(newBox) Then
        Throw New Exception("Server did not unsubscribe the mailbox.")
    End If

    ' メールボックスの名前を変更してから、メールボックスを削除します。
    newBox.Name = newBox.Name & "_Renamed"
    imap1.Mailboxes.Remove(newBox)

    ' セッションから適切にログアウトします。
    imap1.Close()
End Sub

参照

Mailbox クラス
 Mailbox メンバ