Log イベント

データの読み取りまたは書き込みが行われたときに発生します。

シンタックス

Visual Basic (宣言)
C#

[Description("Raised when data is read or written.")]
[Category("Marshaled Data")]
public event EventHandler<DataEventArgs> Log

<DescriptionAttribute("Raised when data is read or written.")>
<CategoryAttribute("Marshaled Data")>
Public Event Log As EventHandler(Of DataEventArgs)

イベントデータ

イベントハンドラが、このイベントに関連するデータを含む、DataEventArgs 型の引数を受け取りました。次の DataEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Data	DataおよびLogイベントによって提供されたデータを取得します。
Message Dart.Ftp.UserStateEventArgsから継承されます。	Marshalメソッドによって提供されたメッセージ引数を返します。
UserState Dart.Ftp.UserStateEventArgsから継承されます。	Marshalメソッドによって提供されたユーザー状態引数を返します。

解説

ハンドラは接続する前に追加する必要があります。イベントハンドラでのUIコントロールの更新については、SynchronizingObjectプロパティを参照してください。

使用例

以下のサンプルコードは、送受信されたデータのログをディスク上のファイルに記録する方法を示します。

private FileStream logFile =
        new FileStream(Application.StartupPath + "\\logFile.txt", FileMode.Append, FileAccess.Write);

private void myComponent_Log(object sender, DataEventArgs e)
{
    string prompt = (e.Data.Direction == DataDirection.In) ? "Recv: " : "Sent: ";
    logFile.Write(System.Text.Encoding.Default.GetBytes(prompt), 0, prompt.Length);
    logFile.Write(e.Data.Buffer, e.Data.Offset, e.Data.Count);
    logFile.Write(System.Text.Encoding.Default.GetBytes("\r\n"), 0, 2);
}

Visual Basic

Private logFile As FileStream = New FileStream(Application.StartupPath & "\logFile.txt", FileMode.Append, FileAccess.Write)

Private Sub myComponent_Log(ByVal sender As Object, ByVal e As DataEventArgs)
  Dim prompt As String
  prompt = If((e.Data.Direction = DataDirection.In), "Recv: ", "Sent: ")
  logFile.Write(System.Text.Encoding.Default.GetBytes(prompt), 0, prompt.Length)
  logFile.Write(e.Data.Buffer, e.Data.Offset, e.Data.Count)
  logFile.Write(System.Text.Encoding.Default.GetBytes(Constants.vbCrLf), 0, 2)
End Sub

参照

関連項目