Progress イベント

zip ファイルとの間でデータが読み書きされている間に発生します。

構文

Visual Basic
C#

'宣言
 
Public Event Progress As ZipProgressEventHandler

public event ZipProgressEventHandler Progress

イベントデータ

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

プロパティ	解説
Cancel	現在の操作をキャンセルする場合は true に設定します。
FileLength	圧縮または展開されているファイルの長さを取得します。
FileLengthLong	圧縮または展開されているファイルの長さを取得します。
FileName	圧縮または展開されているファイルの名前を取得します。
Position	ストリーム内の現在の位置を取得します。
PositionLong	ストリーム内の現在の位置を取得します。

解説

通常、時間がかかる操作中にアプリケーションの UI を更新するために、このイベントを使用します。また、操作をキャンセルするために使用することもできます。

使用例

以下のコードは、アプリケーションがファイルを圧縮している間に、出力ウィンドウにメッセージを書き込みます。

void Compress()
{
// zip ファイルを作成します
C1Zip zip = new C1Zip();
zip.Create(zipFileName);

// イベントハンドラを接続します
zip.Progress += new ZipProgressEventHandler(zip_Progress);

// ファイルを追加します
foreach (string fileName in Directory.GetFiles(path, "*.*"))
zip.Entries.Add(fileName);
}

// ファイルの圧縮中にメッセージを出力します
void zip_Progress(object sender, ZipProgressEventArgs e)
{
Console.WriteLine("Compressing {0}, {1:p0} done",
e.FileName, e.Position/(float)e.FileLength);
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

関連項目