BencodeFormatException Class

Definition

Namespace: Bodu.Text.Bencode

Assembly: Bodu.Text.Bencode.dll

Package: Bodu.Text.Bencode 1.0.0

Source: BencodeFormatException.cs

Represents an error that occurs when bencoded data is malformed.

public sealed class BencodeFormatException : FormatException, ISerializable

Inheritance: object

Exception

SystemException

FormatException

BencodeFormatException

Implements: ISerializable

Inherited Members: Exception.GetBaseException()

Exception.GetType()

Exception.ToString()

Exception.Data

Exception.HelpLink

Exception.HResult

Exception.InnerException

Exception.Message

Exception.Source

Exception.StackTrace

Exception.TargetSite

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.ReferenceEquals(object, object)

Extension Methods: ComparableExtensions.AtLeast<T>(T, T, IComparer<T>)

ComparableExtensions.AtMost<T>(T, T, IComparer<T>)

ComparableExtensions.IsEqualTo<T>(T, T, IComparer<T>)

ComparableExtensions.Max<T>(T, T, IComparer<T>)

ComparableExtensions.Min<T>(T, T, IComparer<T>)

Examples

try
{
    TorrentInfo info = BencodeSerializer.Deserialize<TorrentInfo>(payload);
}
catch (BencodeFormatException ex)
{
    Console.Error.WriteLine($"Malformed bencode at byte {ex.Offset}: {ex.Message}");
}

Remarks

Raised by Read() - and therefore surfaced by BencodeSerializer while deserializing - when the input cannot be interpreted as a valid bencoded document: for example, when an unexpected prefix byte is encountered, an integer is missing its terminating e, a string's length prefix does not fit the remaining bytes, a dictionary's keys are not in lexicographic order, or the document contains trailing bytes after a complete value.

Malformed input and binding failures are reported separately: catch BencodeFormatException (a FormatException ) for bytes that are not valid Bencode, and BencodeSerializationException for values or documents that cannot be mapped; catch both when the handling should not distinguish the cause.

Constructors