ドキュメント・サンプル

using System;
using System.Diagnostics;
using System.Text;

using Smdn.Net;
using Smdn.Net.MessageAccessProtocols.Diagnostics;
using Smdn.Net.Pop3.Protocol.Client;

public class CustomTraceListener : TraceListener {
  public CustomTraceListener(string name)
    : base(name)
  {
  }

  public override void TraceData(TraceEventCache eventCache, string source, TraceEventType eventType, int id, object data)
  {
    if (data is ReceiveTraceData) {
      var received = data as ReceiveTraceData;
      var recv = Encoding.ASCII.GetString(received.Data.Array, received.Data.Offset, received.Data.Count);

      Write("受信内容:\t");
      WriteLine(recv);
    }
    else if (data is SendTraceData) {
      var sent = data as SendTraceData;
      var snt = Encoding.ASCII.GetString(sent.Data.Array, sent.Data.Offset, sent.Data.Count);

      Write("送信内容:\t");
      WriteLine(snt);
    }
    else if (data is MessageTraceData) {
      WriteLine((data as MessageTraceData).Message);
    }
    else if (data is ExceptionTraceData) {
      WriteLine((data as ExceptionTraceData).Exception);
    }
    else {
      base.TraceData(eventCache, source, eventType, id, data);
    }
  }

  public override void Write(string message)
  {
    // TODO
  }

  public override void WriteLine(string message)
  {
    // TODO
  }
}

public static class Test {
  [STAThread]
  public static void Main(string[] args) {
    // カスタマイズしたトレースリスナを追加
    PopConnection.TraceSource.Listeners.Add(new CustomTraceListener("log"));
      :
      :
  }
}

/*
 * ホスト"pop.example.net"のPOPSデフォルトポート(995)にSSL/TLSを用いて接続。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式は対応しているものを順に試行。
 */
var client1 = new PopClient(new Uri("pops://user@pop.example.net/"));

client1.Connect("pass");

/*
 * ホスト"pop.example.net"のポート10110に接続、可能ならSSL/TLSにアップグレード。
 * ユーザ名に"user"を使用、パスワードはNetworkCredentialから取得。　認証方式はAPOPを試行。
 */
var client2 = new PopClient(new Uri("pop://user;AUTH=+APOP@pop.example.net:10110/"));

client2.Profile.UseTlsIfAvailable = true;
client2.Connect(new NetworkCredential("user", "pass"));

/*
 * ホスト"pop.example.net"のポート10110にSSL/TLSを用いて接続。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式はDIGEST-MD5を試行。
 */
var client3 = new PopClient("pop.example.net", 10110, true, "user", "DIGEST-MD5");

client3.Connect("pass");

/*
 * ホスト"pop.example.net"のPOPデフォルトポート(110)に接続、SSL/TLSは使用しない。
 * ユーザ名に"user"を使用、パスワードはNetworkCredentialから取得。　認証方式はDIGEST-MD5, CRAM-MD5, APOP, USER/PASSの順に試行。
 */
var client4 = new PopClient("pop.example.net", -1, false, null, "*");

client4.Profile.UseTlsIfAvailable = false;
client4.Profile.UsingSaslMechanisms = new[] {"DIGEST-MD5", "CRAM-MD5", "+APOP"};

client4.Connect(new NetworkCredential("user", "pass"));

/*
 * ホスト"pop.example.net"のPOPデフォルトポート(110)に接続、可能ならSSL/TLSを使用する。
 * ユーザ名に"user"を使用、パスワードはNetworkCredentialから取得。
 * 認証方式はCRAM-MD5, PLAIN, APOP, USER/PASSの順に試行。　ただしSSL/TLSが使用できない場合、平文による認証を許可しない。
 */
var client5 = new PopClient(new Uri("pop://user@pop.example.net/"));

client5.Profile.UseTlsIfAvailable = true;
client5.Profile.UsingSaslMechanisms = new[] {"CRAM-MD5", "PLAIN"};
client5.Profile.AllowInsecureLogin = false;

client5.Connect(new NetworkCredential("user", "pass"));

/*
 * GMailのアカウント"user"にPOPで接続。　パスワードは"pass"を使用。
 */
var client6 = new PopClient(new Uri("pops://user@pop.gmail.com/"));

client6.Connect("pass");

using System;
using System.Net;
using System.Net.Security;
using System.Security.Cryptography.X509Certificates;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
using Smdn.Net.Pop3.Protocol.Client;

public class ValidateServerCerts {
  public static void Main(string[] args)
  {
    // 証明書の検証を行うコールバックメソッドを指定
    PopConnection.ServerCertificateValidationCallback += ValidateRemoteCertificate;

    using (var client = new PopClient(new Uri("pops://user@localhost/"))) {
      client.Connect("pass");
    }
  }

  private static bool ValidateRemoteCertificate(object sender,
                                                X509Certificate certificate,
                                                X509Chain chain,
                                                SslPolicyErrors sslPolicyErrors)
  {
#if DEBUG
    // デバッグ時のみSslPolicyErrors.RemoteCertificateNameMismatchを無視
    if ((int)(sslPolicyErrors & SslPolicyErrors.RemoteCertificateNameMismatch) != 0)
      sslPolicyErrors &= ~SslPolicyErrors.RemoteCertificateNameMismatch;
#endif

    if (sslPolicyErrors == SslPolicyErrors.None) {
      return true;
    }
    else {
      // エラーがあれば標準エラーに表示
      Console.Error.WriteLine(sslPolicyErrors);
      return false;
    }
  }
}

// popおよびpopsスキームの登録
PopWebRequestCreator.RegisterPrefix();

/*
 * ホスト"pop.example.net"のPOPSデフォルトポート(995)にSSL/TLSを用いて接続。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式は対応しているものを順に試行。
 */
var request1 = WebRequest.Create(new Uri("pops://user@pop.example.net/"));

request1.Credentials = new NetworkCredential("user", "pass");

/*
 * ホスト"pop.example.net"のポート10110に接続、可能ならSSL/TLSにアップグレード。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式はAPOPを試行。
 */
var request2 = WebRequest.Create(new Uri("pop://user;AUTH=+APOP@pop.example.net:10110/")) as PopWebRequest;

request2.UseTlsIfAvailable = true;
request2.Credentials = new NetworkCredential("user", "pass");

/*
 * ホスト"pop.example.net"のポート10110にSSL/TLSを用いて接続。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式はDIGEST-MD5を試行。
 */
var request3 = WebRequest.Create(new Uri("pops://user;AUTH=DIGEST-MD5@pop.example.net:10110/")) as PopWebRequest;

request3.Credentials = new NetworkCredential("user", "pass");

/*
 * ホスト"pop.example.net"のPOPデフォルトポート(110)に接続、SSL/TLSは使用しない。
 * ユーザ名に"user"、パスワードに"pass"を使用。　認証方式はDIGEST-MD5, CRAM-MD5, APOP, USER/PASSの順に試行。
 */
var request4 = WebRequest.Create(new Uri("pop://;AUTH=*@pop.example.net/")) as PopWebRequest;

request4.UseTlsIfAvailable = false;
request4.UsingSaslMechanisms = new[] {"DIGEST-MD5", "CRAM-MD5", "+APOP"};
request4.Credentials = new NetworkCredential("user", "pass");

/*
 * ホスト"pop.example.net"のPOPデフォルトポート(110)に接続、可能ならSSL/TLSを使用する。
 * ユーザ名に"user"、パスワードに"pass"を使用。
 * 認証方式はCRAM-MD5, PLAIN, APOP, USER/PASSの順に試行。　ただしSSL/TLSが使用できない場合、平文による認証を許可しない。
 */
var request5 = WebRequest.Create(new Uri("pop://user@pop.example.net/")) as PopWebRequest;

request5.UseTlsIfAvailable = true;
request5.UsingSaslMechanisms = new[] {"CRAM-MD5", "PLAIN"};
request5.AllowInsecureLogin = false;
request5.Credentials = new NetworkCredential("user", "pass");

/*
 * GMailのアカウント"user"にPOPで接続。　パスワードは"pass"を使用。
 */
var request6 = WebRequest.Create(new Uri("pops://user@pop.gmail.com/"));

request6.Credentials = new NetworkCredential("user", "pass");

using System;
using System.Net;
using System.Net.Security;
using System.Security.Cryptography.X509Certificates;
using Smdn.Net.Pop3;
using Smdn.Net.Pop3.WebClients;

public class ValidateServerCerts {
  public static void Main(string[] args)
  {
    PopWebRequestCreator.RegisterPrefix();

    // 証明書の検証を行うコールバックメソッドを指定
    PopSessionManager.ServerCertificateValidationCallback += ValidateRemoteCertificate;

    using (var client = new WebClient()) {
      client.Credentials = new NetworkCredential("user", "pass");
      client.DownloadFile("pops://user@localhost/;MSG=1", "sample.eml");
    }
  }

  private static bool ValidateRemoteCertificate(object sender,
                                                X509Certificate certificate,
                                                X509Chain chain,
                                                SslPolicyErrors sslPolicyErrors)
  {
#if DEBUG
    // デバッグ時のみSslPolicyErrors.RemoteCertificateNameMismatchを無視
    if ((int)(sslPolicyErrors & SslPolicyErrors.RemoteCertificateNameMismatch) != 0)
      sslPolicyErrors &= ~SslPolicyErrors.RemoteCertificateNameMismatch;
#endif

    if (sslPolicyErrors == SslPolicyErrors.None) {
      return true;
    }
    else {
      // エラーがあれば標準エラーに表示
      Console.Error.WriteLine(sslPolicyErrors);
      return false;
    }
  }
}

using System;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;

class SaveToFile {
  public static void Main(string[] args)
  {
    using (var client = new PopClient(new Uri("pop://user;AUTH=DIGEST-MD5@localhost/"))) {
      client.Connect("pass");

      // メールボックスにある1件目のメッセージをダウンロード
      var message = client.GetFirstMessage();

      // ファイルsample.emlに保存
      message.Save("sample.eml");
    }
  }
}

using System;
using System.Net;
using System.Text;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
using Smdn.Net.Pop3.Protocol.Client;

class GpopRetrieveRecent {
  public static void Main(string[] args)
  {
    PopConnection.ServerCertificateValidationCallback += delegate {
      // 証明書の検証は省略 (エラーを無視してすべて受け入れる)
      return true;
    };

    using (var client = new PopClient(new Uri("pops://user@pop.gmail.com/"))) {
      client.Connect("pass");

      if (client.MessageCount == 0) {
        // メールボックスにメッセージがない
        Console.WriteLine("no messages");
        return;
      }

      // メールボックスにある最後のメッセージを取得
      var message = client.GetLastMessage();

      // メッセージ本文をダウンロードし、iso-2022-jpでデコードして表示
      Console.WriteLine(message.ReadAllText(Encoding.GetEncoding("iso-2022-jp")));
    }
  }
}

using System;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
using Smdn.Net.Pop3.Protocol.Client;

class SaveAndDelete {
  public static void Main(string[] args)
  {
    PopConnection.ServerCertificateValidationCallback += delegate {
      // 証明書の検証は省略 (エラーを無視してすべて受け入れる)
      return true;
    };

    using (var client = new PopClient(new Uri("pops://user;auth=ntlm@localhost/"))) {
      client.Connect("pass");

      // メッセージ本文を取得したら削除する
      client.DeleteAfterRetrieve = true;

      // メールボックスにあるすべてのメッセージとIDを取得
      foreach (var message in client.GetMessages(true)) {
        // IDをファイル名として保存 (IDがファイル名として妥当かどうかのチェックは省略)
        message.Save(message.UniqueId + ".eml");
      }

      // ログアウトしてメッセージを削除
      client.Logout();
    }
  }
}

        :
      client.DeleteAfterRetrieve = false;

      // メールボックスにあるすべてのメッセージとIDを取得
      foreach (var message in client.GetMessages(true)) {
        // IDをファイル名として保存 (IDがファイル名として妥当かどうかのチェックは省略)
        message.Save(message.UniqueId + ".eml");
        // 保存できたら削除マークを付ける
        message.MarkAsDeleted();
      }
        :
        :

using System;
using System.Collections.Generic;
using System.Threading;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;

class CheckRecent {
  public static void Main(string[] args)
  {
    // 既知のメッセージID
    var ids = new List<string>();

    using (var client = new PopClient(new Uri("pop://user;auth=ntlm@localhost/"))) {
      client.Profile.UseTlsIfAvailable = false;

      for (;;) {
        client.Connect("pass");

        if (!client.ServerCapabilities.Has(PopCapability.Uidl))
          // サーバがUIDLをサポートしていない
          throw new ApplicationException("UIDL incapable");

        // メールボックスにあるすべてのメッセージを取得
        foreach (var message in client.GetMessages(true)) {
          // 既知のメッセージIDかどうかチェック
          if (ids.Contains(message.UniqueId)) {
            // 既知の場合は何もしない
          }
          else {
            // 新着の場合は、メッセージ本文のヘッダのみを取得
            foreach (var line in message.ReadLines(0)) {
              // ヘッダのうち"Subject:"で始まる行のみを表示
              if (line.StartsWith("Subject:", StringComparison.OrdinalIgnoreCase))
                Console.WriteLine("{0}: {1}", message.UniqueId, line);
            }

            // 既知のメッセージIDとして追加
            ids.Add(message.UniqueId);
          }
        }

        // いったん切断
        client.Disconnect();

        // 5分後に再接続する
        Thread.Sleep(TimeSpan.FromMinutes(5.0));
      }
    }
  }
}
();

    using (var client = new PopClient(new Uri("pop://user;auth=ntlm@localhost/"))) {
      client.Profile.UseTlsIfAvailable = false;

      for (;;) {
        client.Connect("pass");

        if (!client.ServerCapabilities.Has(PopCapability.Uidl))
          // サーバがUIDLをサポートしていない
          throw new ApplicationException("UIDL incapable");

        // メールボックスにあるすべてのメッセージを取得
        foreach (var message in client.GetMessages(true)) {
          // 既知のメッセージIDかどうかチェック
          if (ids.Contains(message.UniqueId)) {
            // 既知の場合は何もしない
          }
          else {
            // 新着の場合は、メッセージ本文のヘッダのみを取得
            foreach (var line in message.ReadLines(0)) {
              // ヘッダのうち"Subject:"で始まる行のみを表示
              if (line.StartsWith("Subject:", StringComparison.OrdinalIgnoreCase))
                Console.WriteLine("{0}: {1}", message.UniqueId, line);
            }

            // 既知のメッセージIDとして追加
            ids.Add(message.UniqueId);
          }
        }

        // いったん切断
        client.Disconnect();

        // 5分後に再接続する
        Thread.Sleep(TimeSpan.FromMinutes(5.0));
      }
    }
  }
}]]>

using System;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client;
using Smdn.Formats.Mime;

class DecodeMime {
  public static void Main(string[] args)
  {
    using (var client = new PopClient(new Uri("pop://user;auth=ntlm@localhost/"))) {
      client.Profile.UseTlsIfAvailable = false;

      client.Connect("pass");

      // すべてのメッセージを取得
      foreach (var message in client.GetMessages()) {
        // メッセージの本文を取得し、MimeMessage.Loadメソッドでパース・デコードした結果を得る
        var decodedMessage = message.ReadAs<MimeMessage>(MimeMessage.Load);

        // デコードしたメッセージの件名を表示
        Console.WriteLine("====[{0}: {1}]{2}",
                          message.MessageNumber,
                          decodedMessage.Headers["Subject"].Value,
                          new string('=', 32));

        // デコードした本文を表示
        if (parsedMessage.MimeType.TypeEqualsIgnoreCase("text"))
          Console.WriteLine(decodedMessage.ReadContentAsText());
        else
          Console.WriteLine("非テキストメッセージです");
      }
    }
  }
}
(MimeMessage.Load);

        // デコードしたメッセージの件名を表示
        Console.WriteLine("====[{0}: {1}]{2}",
                          message.MessageNumber,
                          decodedMessage.Headers["Subject"].Value,
                          new string('=', 32));

        // デコードした本文を表示
        if (parsedMessage.MimeType.TypeEqualsIgnoreCase("text"))
          Console.WriteLine(decodedMessage.ReadContentAsText());
        else
          Console.WriteLine("非テキストメッセージです");
      }
    }
  }
}]]>

using System;
using System.Net;

using Smdn.Net.Pop3.WebClients;

class SaveToFile {
  public static void Main(string[] args)
  {
    PopWebRequestCreator.RegisterPrefix();

    using (var client = new WebClient()) {
      client.Credentials = new NetworkCredential("user", "pass");

      // メールボックスにある1件目のメッセージをダウンロードしてファイルsample.emlに保存
      client.DownloadFile("pop://user;AUTH=DIGEST-MD5@localhost/;MSG=1", "sample.eml");
    }
  }
}

using System;
using System.IO;
using System.Text;
using System.Net;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.WebClients;

class GpopRetrieveRecent {
  public static void Main(string[] args)
  {
    PopWebRequestCreator.RegisterPrefix();
    PopSessionManager.ServerCertificateValidationCallback += delegate {
      // 証明書の検証は省略 (エラーを無視してすべて受け入れる)
      return true;
    };

    var baseUrl = new Uri("pops://user@pop.gmail.com/");
    var credential = new NetworkCredential("user", "pass");

    // STATコマンドでメールボックスにあるメッセージの数を取得
    var request = WebRequest.Create(baseUrl) as PopWebRequest;

    request.Credentials = credential;
    request.Method = "STAT";
    request.KeepAlive = true; // リクエストが完了しても接続したままにする

    long recentMessageNumber;

    using (var response = request.GetResponse() as PopWebResponse) {
      recentMessageNumber = response.DropList.MessageCount;
    }

    if (recentMessageNumber == 0) {
      // メールボックスにメッセージがない
      Console.WriteLine("no messages");
      return;
    }

    // 取得するメッセージ番号を含む相対URLを作成
    var recentMessageUrl = string.Format("./;MSG={0}", recentMessageNumber);

    // RETRコマンドでメッセージの本文を取得
    request = WebRequest.Create(new Uri(baseUrl, recentMessageUrl)) as PopWebRequest;

    request.Credentials = credential;
    request.Method = "RETR";
    request.KeepAlive = false; // リクエストが完了したら切断する

    using (var response = request.GetResponse()) {
      using (var stream = response.GetResponseStream()) {
        // メッセージ本文をiso-2022-jpでデコードして表示
        var reader = new StreamReader(stream, Encoding.GetEncoding("iso-2022-jp"));

        Console.WriteLine(reader.ReadToEnd());
      }
    }
  }
}

using System;
using System.IO;
using System.Text;
using System.Net;

using Smdn.Net.Pop3;
using Smdn.Net.Pop3.Client.Session;
using Smdn.Net.Pop3.Protocol.Client;

class Sample {
  public static void Main(string[] args)
  {
    PopConnection.ServerCertificateValidationCallback += delegate {
      // 証明書の検証は省略 (エラーを無視してすべて受け入れる)
      return true;
    };

    using (var session = new PopSession("pop.gmail.com", 995, PopConnection.CreateSslStream)) {
      var cred = new NetworkCredential("user", "pass");

      // 利用可能ならAPOP、そうでなければUSER/PASSでログイン
      var authenticationResult = session.ApopAvailable
        ? session.Apop(cred)
        : session.Login(cred);

      if (authenticationResult.Failed) {
        Console.Error.WriteLine("authentication failed");
        return;
      }

      // STATコマンドを発行
      PopDropListing dropList;

      if (session.Stat(out dropList).Failed) {
        Console.Error.WriteLine("STAT failed");
        return;
      }

      if (dropList.MessageCount == 0L) {
        // メールボックスにメッセージがない
        Console.Error.WriteLine("no message exists");
        return;
      }

      // RETRコマンドでメッセージ本文を取得・表示
      PopMessage message;

      if (session.Retr(dropList.MessageCount, out message).Failed) {
        Console.Error.WriteLine("RETR failed");
        return;
      }

      var reader = new StreamReader(message.Body, Encoding.GetEncoding("iso-2022-jp"));

      Console.WriteLine(reader.ReadToEnd());

      message.Dispose();

      // DELEコマンドでメッセージを削除マーク済みにする
      if (session.Dele(message.Number).Failed) {
        Console.Error.WriteLine("DELE failed");
        return;
      }

      // QUITコマンドでメッセージを削除してログアウト
      if (session.Quit().Failed) {
        Console.Error.WriteLine("QUIT failed");
        return;
      }
    }
  }
}