Get(Stream,Int32) メソッド

指定したボディ行数のエンコードされたメッセージをサーバーから取得し、それを指定したStreamに書き込みます。ヘッダは常に含まれます。

シンタックス

Visual Basic (宣言)
C#

Public Overloads Sub Get( _
   ByVal destination As Stream, _
   ByVal bodyLines As Integer _
)

public void Get( 
   Stream destination,
   int bodyLines
)

パラメータ

destination: 書き込み先のStream。
bodyLines: サーバーに要求するボディ行の行数。メッセージ全体を指定する場合は-1を使用します。ヘッダのみを取得する場合は0を使用します。

解説

このメソッドは部分的なメッセージを取得します。通常はPart.GetEncodingStreamを宛先Streamとしてオンザフライでデコードしますが、ストレージストリームを使用してメッセージをデコードせずに保存することもできます。

このメソッドはInfoをbodyLinesの値に合わせて設定します。

使用例

以下のサンプルコードでは、Popコンポーネントを使用してメッセージのヘッダのみを取得し、送信者、件名、および日付をリストに追加します。

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

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

    // アカウントの各メッセージのヘッダフィールドを取得します。
    foreach (PopMessage popMessage in pop1.Messages)
        popMessage.Get(0);

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

private void pop1_Progress(object sender, PopProgressEventArgs e)
{
    // メッセージヘッダの情報をリストビューに表示します。
    if (e.Final)
    {
        string[] header = { e.Message.Message.From, e.Message.Message.Subject, e.Message.Message.Date.ToString() };
        listView1.Items.Add(new ListViewItem(header));
    }
}

Visual Basic

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

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

    ' アカウントの各メッセージのヘッダフィールドを取得します。
    For Each popMessage As PopMessage In pop1.Messages
        popMessage.Get(0)
    Next popMessage

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

Private Sub pop1_Progress(ByVal sender As Object, ByVal e As PopProgressEventArgs) Handles pop1.Progress
    ' メッセージヘッダの情報をリストビューに表示します。
    If e.Final Then
        Dim header() As String = { e.Message.Message.From, e.Message.Message.Subject, e.Message.Message.Date.ToString() }
        listView1.Items.Add(New ListViewItem(header))
    End If
End Sub

参照

PopMessage クラス
 PopMessage メンバ
 オーバーロード一覧