Avoid subtle, undesired outcomes when using ImageGear's Simplified Metadata API.
Because the Simplified Metadata API reuses ImageGear's General Metadata tree for storage, getting a value for a property representing either an array or another tree-like data structure returns a cloned object. Optimizing reads to such properties will improve performance. When updating values to such properties, also beware of losing changes from not setting the property's updated value after changes are made.
This sample shows recommended techniques when working with the Simplified Metadata API, using XMP.DublinCore.Subject as an example.
For more information about the ImageGear .NET API, please refer to the ImageGear .NET Online Documentation.
For a list of the system and development software necessary to build and run these samples, please refer to the ImageGear .NET Online Documentation.
Starting with ImageGear v26.0, ImageGear supports .NET Core.
All samples can be built using Microsoft Visual Studio 2022.
To build this sample:
- Open the .sln file in the project directory using Visual Studio 2022.
- Select a Solution Configuration (Debug or Release) and an available Solution Platform (x64 or Any CPU).
- Build with Build Solution located in the Build menu.
To build this sample under Linux:
- Install the Microsoft .NET SDK for your Linux distribution.
- Run
dotnet build MetadataSimplifiedAPIUseArraysAndStructures.sln. By default this will build the Debug Solution Configuration.
When the sample is built, it produces a console application executable in the bin subdirectory. Run this application by double-clicking the application icon, or run it directly from Command Prompt (cmd.exe), PowerShell, or similar. Note that the working directory must be the same as the directory containing the sample executable in order to find the sample input image and the output directory. The input image(s) and output directory are specified relative to the location of the application in all of these samples.
To run this sample under Linux, run the sample from "bin/Debug/net6.0/" (depending on the solution platform) using ./MetadataSimplifiedAPIUseArraysAndStructures.
NOTE: ImageGear .NET runs in evaluation mode if started without a license. In evaluation mode, documents and images will be watermarked when exported or displayed. If you would like to work with a full-featured evaluation of the product, please contact Accusoft at info@accusoft.com.
ImageGear .NET supports the most commonly used image, graphic, and document formats. For more information on imaging support in ImageGear .NET, please visit us at Accusoft.