Relates to previous commit. Following discussion with Adam, moved the Cancel() to the reader.
Example:
while (reader.MoveToNextEntry())
{
using (var data = new StreamReader(reader.OpenEntryStream()))
{
try
{
DoSomething(data.ReadLine());
}
catch
{
reader.Cancel();
throw;
}
}
}
Until now the caller had to completely consume each entry stream, or call SkipEntry(), before disposing the stream. If not, exception was thrown: "EntryStream has not been fully consumed". Hugely inconvenient; a user-thrown exception inside a "using (EntryStream)" block would be discarded.
Now automatically skips the entry on dispose.
Added method EntryStream.Cancel(). Call this if entry stream is unfinished, and no further entries are required. Helps with efficiency, as it avoids reading data that is not needed.
