Authenticate メソッド (Pop)

MailSession.Authenticationに従ってクライアントを認証し、Messagesに情報を格納します。

シンタックス

Visual Basic (宣言)
C#

Public Sub Authenticate( _
   ByVal getSizes As Boolean, _
   ByVal getUids As Boolean _
)

public void Authenticate( 
   bool getSizes,
   bool getUids
)

パラメータ

getSizes: trueの場合、すべてのメッセージについてMessageBase.Sizeが初期化されます。
getUids: trueの場合、すべてのメッセージについてMessageBase.Uidが初期化されます。

例外

例外	解説
ProtocolException	サーバーから受信したPOPプロトコル応答が不良です。
System.Net.Sockets.SocketException	要求されたアドレスがそのコンテキストで有効ではありません。

解説

Session.Security.Encrypt == Encrypt.Explicitの場合は、SSLセキュリティがネゴシエートされます。

Pop.Messages.Sizeが初期化されます。

PopMessage.Getを使用してメッセージを取得できます。Popコンポーネントは、Closeが呼び出されるまでログイン状態にとどまります。

使用例

以下のサンプルコードでは、Popコンポーネントによってメッセージを取得した後、ディスクに保存します。

private void getMessages(object sender)
{
    // 接続してアカウントにログインします。
    pop1.Connect();
    pop1.Authenticate(true, true);

    // アカウントのすべてのメッセージをダウンロードし、一意のファイル名でディスクに保存します。
    string messageFolder = Application.StartupPath + "\\messages";
    foreach (PopMessage popMessage in pop1.Messages)
    {
        popMessage.Get();
        popMessage.Message.Save(messageFolder + "\\" + popMessage.Id.ToString("D4") + ".eml");
    }

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

private void pop1_Progress(object sender, PopProgressEventArgs e)
{
    // メッセージの受信状況に従ってプログレスバーを更新します。
    progressBar1.Value = (e.Final) ? 0 : (int)((e.Position * 100) / e.Length);
}

Visual Basic

Private Sub getMessages(ByVal sender As Object)
    ' 接続してアカウントにログインします。
    pop1.Connect()
    pop1.Authenticate(True, True)

    ' アカウントのすべてのメッセージをダウンロードし、一意のファイル名でディスクに保存します。
    Dim messageFolder As String = Application.StartupPath & "\messages"
    For Each popMessage As PopMessage In pop1.Messages
        popMessage.Get()
        popMessage.Message.Save(messageFolder & "\" & popMessage.Id.ToString("D4") & ".eml")
    Next popMessage

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

Private Sub pop1_Progress(ByVal sender As Object, ByVal e As PopProgressEventArgs) Handles pop1.Progress
    ' メッセージの受信状況に従ってプログレスバーを更新します。
    progressBar1.Value = If(e.Final, 0, CInt((e.Position * 100) \ e.Length))
End Sub

参照

Pop クラス
 Pop メンバ