GroupDocs.Metadata for .NET 17.09 Release Notes Leave feedback
NoteThis page contains release notes for GroupDocs.Metadata for .NET 17.09.0
There are 4 new features, 1 enhancement and 1 fix in this regular monthly release. The most notable are:
- Ability to read APEv2 metadata in MP3 format
- Ability to read and update metadata of ODS format
- Ability to read SRational TIFF tag in JPEG and TIFF image formats
- Ability to add or update TIFF tags in EXIF
| Key | Summary | Category |
|---|---|---|
| METADATANET-1214 | Ability to read APEv2 metadata in MP3 format | New Feature |
| METADATANET-1329 | Ability to read and update metadata of ODS format | New Feature |
| METADATANET-1872 | Ability to read SRational TIFF tag in JPEG and TIFF image formats | New Feature |
| METADATANET-1883 | Ability to add or update TIFF tags in EXIF | New Feature |
| METADATANET-1878 | Several TIFF tags are lost after changing EXIF properties | Bug |
| METADATANET-1891 | Prevent to crash export process in case of converting large objects to csv | Enhancement |
NoteThis section lists public API changes that were introduced in GroupDocs.Metadata for .NET 17.09.0 It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in GroupDocs.Metadata which may affect existing code. Any behavior introduced that could be seen as a regression and modifies existing behavior is especially important and is documented here.
Several EXIF tags not found after updating EXIF property. This bug has now been fixed.
None
Usecase.
string spath = @"C:\Users\User\Desktop\source.jpg";
JpegFormat jpegFormat = new JpegFormat(spath);
JpegExifInfo exif = (JpegExifInfo)jpegFormat.ExifValues;
exif.Artist = string.Empty;
string fpath = @"C:\Users\User\Desktop\Change.jpg";
jpegFormat.Save(fpath);
In several cases metadata value of the specific key may be too large (more than 32 KBytes). Previous versions did not handle such case so user may get exception.
None
Usecase.
// path to the target file
const string path = @"C:\summer_2017_2.jpg";
// path to the output file
const string outputPath = @"C:\metadata.xlsx";
// export to excel
byte[] content = ExportFacade.ExportToExcel(path);
// write data to the file
File.WriteAllBytes(outputPath, content);
This feature allows to read APEv2 metadata in MP3 format.
Added Apev2Metadata class into GroupDocs.Metadata.Formats.Audio namespace
This example demonstrates how to read APEv2 tag in MP3 format.
// path to the input directory
string dir = @"C:\\download files";
// get all files inside directory
string[] files = Directory.GetFiles(dir, "*.mp3");
foreach (string file in files)
{
// initialize Mp3Format. If file is not Mp3 then appropriate exception will throw.
Mp3Format mp3Format = new Mp3Format(file);
// get APEv2 tag
Apev2Metadata apev2 = mp3Format.APEv2;
//NOTE: please remember you may use different approaches to getting metadata
// second approach
//apev2 = (Apev2Metadata)MetadataUtility.ExtractSpecificMetadata(file, MetadataType.APEv2);
// check if APEv2 tag is presented
if (apev2 != null)
{
// Display tag properties
Console.WriteLine("Album: {0}", apev2.Album);
Console.WriteLine("Artist: {0}", apev2.Artist);
Console.WriteLine("Comment: {0}", apev2.Comment);
Console.WriteLine("Genre: {0}", apev2.Genre);
Console.WriteLine("Title: {0}", apev2.Title);
Console.WriteLine("Track: {0}", apev2.Track);
}
}
This feature allows to read OpenDocument Spreadsheet (ODS) format
None.
This example demonstrates how to read document properties in ODS format.
// path to the ODS file
string path = @"C:\\example.ods";
// initialize XlsFormat
XlsFormat xlsFormat = new XlsFormat(path);
// get document properties
XlsMetadata properties = xlsFormat.DocumentProperties;
// get author
string author = properties.Author;
// get company
string company = properties.Company;
// get created date of the document
DateTime createdDate = properties.CreatedTime;
This feature allows to SRational TIFF tag in JPEG/TIFF image formats.
Added SRational class into namespace GroupDocs.Metadata.Formats.Image
Usecase.
// init JpegFormat
JpegFormat jpegFormat = new JpegFormat(file);
// get exif info
ExifInfo exifInfo = jpegFormat.GetExifInfo();
if (exifInfo != null)
{
// all tags are available in licensed mode only
TiffTag[] allTags = exifInfo.Tags;
foreach (TiffTag tag in allTags)
{
switch (tag.TagType)
{
case TiffTagType.SRational:
TiffSRationalTag srationalTag = tag as TiffSRationalTag;
Console.WriteLine("Tag: {0}, value: {1}", srationalTag.DefinedTag, srationalTag.Value);
break;
}
}
}
This feature allows to add or update custom TIFF tags to EXIF segment in JPEG or TIFF formats.
None.
This example demonstrates how to specify ‘artist’ using TiffAsciiTag tag.
// path to the image
const string file = @"C:\\image.jpeg";
// init JpegFormat
JpegFormat jpegFormat = new JpegFormat(file);
// get existing EXIF or create new one
ExifInfo exif = jpegFormat.GetExifInfo() ?? new ExifInfo();
// define list of tags
List<TiffTag> tags = new List<TiffTag>();
// add specific tag
tags.Add(new TiffAsciiTag(TiffTagIdEnum.Artist, "Jack"));
// and update tags
exif.Tags = tags.ToArray();
// update exif
jpegFormat.UpdateExifInfo(exif);
// and commit changes
jpegFormat.Save();
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
