/// <summary>
/// Constructs and initializes a new instance of <see
/// cref="Tag" /> for a specified <see cref="TagLib.File" />.
/// </summary>
/// <param name="file">
/// A <see cref="TagLib.File" /> object on which the new
/// instance will perform its operations.
/// </param>
/// <remarks>
/// Constructing a new instance does not automatically read
/// the contents from the disk. <see cref="Read" /> must be
/// called to read the tags.
/// </remarks>
public Tag (File file) : base ()
{
start_tag = new StartTag (file);
end_tag = new EndTag (file);
AddTag (start_tag);
AddTag (end_tag);
}
/// <summary>
/// Constructs and initializes a new instance of <see
/// cref="File" /> for a specified file abstraction with an
/// average read style.
/// </summary>
/// <param name="abstraction">
/// A <see cref="IFileAbstraction" /> object to use when
/// reading from and writing to the file.
/// </param>
/// <exception cref="ArgumentNullException">
/// <paramref name="abstraction" /> is <see langref="null"
/// />.
/// </exception>
protected File (File.IFileAbstraction abstraction)
: this (abstraction, ReadStyle.Average)
{
}
/// <summary>
/// Constructs and initializes a new instance of <see
/// cref="File" /> for a specified file abstraction and
/// specified read style.
/// </summary>
/// <param name="abstraction">
/// A <see cref="IFileAbstraction" /> object to use when
/// reading from and writing to the file.
/// </param>
/// <param name="propertiesStyle">
/// A <see cref="ReadStyle" /> value specifying at what level
/// of accuracy to read the media properties, or <see
/// cref="ReadStyle.None" /> to ignore the properties.
/// </param>
/// <exception cref="ArgumentNullException">
/// <paramref name="abstraction" /> is <see langref="null"
/// />.
/// </exception>
protected File (File.IFileAbstraction abstraction,
ReadStyle propertiesStyle)
: base (abstraction)
{
Read (propertiesStyle);
}
