GroupDocs.Metadata for .NET 18.2 Release Notes

// path to the jpg file
string path = @"C:\\download files\\wallpaper.jpg";

// initialize JpegFormat
JpegFormat jpegFormat = new JpegFormat(path);

// get EXIF data
JpegExifInfo exif = (JpegExifInfo)jpegFormat.ExifValues;

// set artist
exif.Artist = "test artist";

// set the name of the camera's owner
exif.CameraOwnerName = "camera owner's name";

// set description
exif.ImageDescription = "test description";

// set software
exif.Software = "software...";

// commit changes
jpegFormat.Save(@"C:\\download files\\result.jpg");

// and free resources
jpegFormat.Dispose();

const string filePath = @"C:\download files\Kalimba.mp3";

// init Mp3Format class
using (Mp3Format mp3Format = new Mp3Format(filePath))
{
 // set album but with invalid length
 mp3Format.Id3v1Properties.Album = "this is very looooooooong album name but must be less 30 characters";

 try
 {
  // and commit changes
  mp3Format.Save();
 }
 catch (GroupDocs.Metadata.Exceptions.GroupDocsException e)
 {
  //e.Message is "Property 'album': Length could not be grater then 30"
  Console.WriteLine(e);
 }
}

const string filePath = @"C:\download files\podcast_001.mp3";

// init Mp3Format class
Mp3Format mp3Format = new Mp3Format(filePath);

// get ID3 v2 tag
Id3v2Tag id3v2 = mp3Format.Id3v2;

if (id3v2 != null)
{
 // read sub-title
 Console.WriteLine("Subtitle: {0}", id3v2.Subtitle);

 // read musical key
 Console.WriteLine("Musical key: {0}", id3v2.MusicalKey);

 // read length in milliseconds
 Console.WriteLine("Length in milliseconds: {0}", id3v2.LengthInMilliseconds);

 // read original album
 Console.WriteLine("Original album: {0}", id3v2.OriginalAlbum);

 // read size in bytes. Please note that is present TSIZ tag and may be overrided by invalid value
 Console.WriteLine("Original album: {0}", id3v2.SizeInBytes);

 // read TSRC value
 Console.WriteLine("Original album: {0}", id3v2.ISRC);

 // read TSSE value
 Console.WriteLine("Original album: {0}", id3v2.SoftwareHardware);

 // read PCNT value
 Console.WriteLine("Original album: {0}", id3v2.PlayCounter);
 }

// and close input stream
mp3Format.Dispose();

const string filePath = @"C:\download files\podcast_001.mp3";

// init Mp3Format class
using (Mp3Format mp3Format = new Mp3Format(filePath))
{
 // get id3v2 tag. It creates new tag if metadata not exist so user does not need to check it by null.
 Id3v2Tag id3Tag = mp3Format.Id3v2Properties;

 // set artist
 id3Tag.Artist = "A-ha";

 // set title
 id3Tag.Title = "Take on me";

 // set band
 id3Tag.Band = "A-ha";

 // set comment
 id3Tag.Comment = "GroupDocs.Metadata creator";

 // set track number
 id3Tag.TrackNumber = "5";

 // set year
 id3Tag.Year = "1986";

 // and commit changes
 mp3Format.Save();
}

const string filePath = @"C:\download files\podcast_001.mp3";

// init Mp3Format class
using (Mp3Format mp3Format = new Mp3Format(filePath))
{
 // get id3v1 tag
 Id3v1Tag id3Tag = mp3Format.Id3v1Properties;

 // set artist
 id3Tag.Artist = "A-ha";

 // set comment
 id3Tag.Comment = "By GroupDocs.Metadata";

 // set title
 id3Tag.Title = "Take on me";

 // set year
 id3Tag.Year = "1986";

 // and commit changes
 mp3Format.Save();
}

// path to the EPUB file
const string file = @"C:\download files\Jack_London_Biography.epub";

// open EPUB file
using (EpubFormat epub = new EpubFormat(file))
{
 // read image cover as array of bytes
 byte[] imageCoverData = epub.GetImageCoverBytes();

 // check if cover is exist
 if (imageCoverData != null)
 {
  // create stream
  using (MemoryStream stream = new MemoryStream(imageCoverData))
  {
   // get image type
   ImageFormat image = ImageFormat.FromStream(stream);

   // display MIME type
   Console.WriteLine("Image type: {0}", image.MIMEType);

   // display dimensions
   Console.WriteLine("width: {0}, height: {1}", image.Width, image.Height);

   // and store it to the file system
   image.Save(string.Format(@"C:\download files\Jack_London_Biography_Cover.{0}", image.Type));
   }
 }
}

// path to the EPUB file
const string file = @"C:\download files\Jack_London_Biography.epub";

// open EPUB file
using (EpubFormat epub = new EpubFormat(file))
{
 // read EPUB metadata
 EpubMetadata metadata = epub.GetEpubMetadata();

 // and get version
 Console.WriteLine("Version = {0}", metadata.Version);
}

const string filePath = @"C:\download files\podcast_001.mp3";

// init Mp3Format class
using (Mp3Format mp3Format = new Mp3Format(filePath))
{
 // get id3v2
 var metadata = mp3Format.GetId3v2Tag();

 // check if ID3v2 is exist
 if (metadata == null)
 {
  return;
 }

 // read APIC frames
 var frames = metadata["APIC"];

 if (frames != null && frames.Length == 1)
 {
  // get AttachedPictureFrame
  AttachedPictureFrame picture = (AttachedPictureFrame)frames[0];

  // use 'jpeg' as default extension
  string extension = ".jpeg";
  string mimeType = picture.MIMEType;

  // try resolve extension from MIME
  if (mimeType != null)
  {
   if (mimeType.Contains("jpg"))
   {
     extension = ".jpeg";
   }
   else if (mimeType.Contains("bmp"))
   {
     extension = ".bmp";
   }
   else if (mimeType.Contains("png"))
   {
     extension = ".png";
   }
  }

  // prepare file name
  string file = string.Format(@"C:\download files\podcast_001_cover{0}", extension);

  // and store it to the file system
  System.IO.File.WriteAllBytes(file, picture.PictureData);
 }
}

const string filePath = @"C:\download files\podcast_001.mp3";
const string outPath = @"C:\download files\podcast_001_nocover.mp3";

// init Mp3Format class
using (Mp3Format mp3Format = new Mp3Format(filePath))
{
 // get id3v2
 var metadata = mp3Format.GetId3v2Tag();

 if (metadata == null)
 {
  return;
 }

 // remove image cover
 metadata.RemoveImageCover();

 // update metadata
 mp3Format.UpdateId3v2(metadata);

 // and store to other file
 mp3Format.Save(outPath);
}