GroupDocs.Metadata for .NET 17.09 Release Notes
Leave feedback
Note
This page contains release notes for GroupDocs.Metadata for .NET 17.09.0
Major Features
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
All Changes
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
Public API and Backward Incompatible Changes
Note
This 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 TIFF tags are lost after changing EXIF properties
Several EXIF tags not found after updating EXIF property. This bug has now been fixed.
Prevent to crash export process in case of converting large objects to Excel or CSV
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.
Public API changes
None
Usecase.
// path to the target fileconststringpath=@"C:\summer_2017_2.jpg";// path to the output fileconststringoutputPath=@"C:\metadata.xlsx";// export to excelbyte[]content=ExportFacade.ExportToExcel(path);// write data to the fileFile.WriteAllBytes(outputPath,content);
Ability to read APEv2 metadata in MP3 format
This feature allows to read APEv2 metadata in MP3 format.
Public API changes
Added Apev2Metadata class into GroupDocs.Metadata.Formats.Audio namespace
This example demonstrates how to read APEv2 tag in MP3 format.
// path to the input directorystringdir=@"C:\\download files";// get all files inside directorystring[]files=Directory.GetFiles(dir,"*.mp3");foreach(stringfileinfiles){// initialize Mp3Format. If file is not Mp3 then appropriate exception will throw.Mp3Formatmp3Format=newMp3Format(file);// get APEv2 tagApev2Metadataapev2=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 presentedif(apev2!=null){// Display tag propertiesConsole.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 example demonstrates how to read document properties in ODS format.
// path to the ODS filestringpath=@"C:\\example.ods";// initialize XlsFormatXlsFormatxlsFormat=newXlsFormat(path);// get document propertiesXlsMetadataproperties=xlsFormat.DocumentProperties;// get authorstringauthor=properties.Author;// get companystringcompany=properties.Company;// get created date of the documentDateTimecreatedDate=properties.CreatedTime;
Ability to read SRational TIFF tag in JPEG and TIFF image formats
This feature allows to SRational TIFF tag in JPEG/TIFF image formats.
Public API changes
Added SRational class into namespace GroupDocs.Metadata.Formats.Image
Usecase.
// init JpegFormatJpegFormatjpegFormat=newJpegFormat(file);// get exif infoExifInfoexifInfo=jpegFormat.GetExifInfo();if(exifInfo!=null){// all tags are available in licensed mode onlyTiffTag[]allTags=exifInfo.Tags;foreach(TiffTagtaginallTags){switch(tag.TagType){caseTiffTagType.SRational:TiffSRationalTagsrationalTag=tagasTiffSRationalTag;Console.WriteLine("Tag: {0}, value: {1}",srationalTag.DefinedTag,srationalTag.Value);break;}}}
Ability to add or update TIFF tags in EXIF
This feature allows to add or update custom TIFF tags to EXIF segment in JPEG or TIFF formats.
Public API changes
None.
This example demonstrates how to specify ‘artist’ using TiffAsciiTag tag.
// path to the imageconststringfile=@"C:\\image.jpeg";// init JpegFormatJpegFormatjpegFormat=newJpegFormat(file);// get existing EXIF or create new oneExifInfoexif=jpegFormat.GetExifInfo()??newExifInfo();// define list of tagsList<TiffTag>tags=newList<TiffTag>();// add specific tagtags.Add(newTiffAsciiTag(TiffTagIdEnum.Artist,"Jack"));// and update tagsexif.Tags=tags.ToArray();// update exifjpegFormat.UpdateExifInfo(exif);// and commit changesjpegFormat.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.