# Migration Notes ## Why to migrate? Here are the key reasons to use the new updated API provided by GroupDocs.Annotation for .NET since version 19.8: * The `Annotator` class introduced as a single entry point to manage the document annotating process to any supported file format (instead of `AnnotationImageHandler` class in previous versions). * The overall rendering speed improved dramatically by saving rendered page as soon as it was rendered, not when all pages list were rendered. * Document saving options simplified so it is easy to instantiate proper options class and to control over document annotating and saving processes. ## How to migrate? Here is a brief comparison of how to annotate document and save it using old and new API. ### Old coding style {{< tabs "example1">}} {{< tab "C#" >}} ```csharp // Creating annotation list List annotations = new List() { new AnnotationInfo() { PageNumber = 0, Box = new Rectangle(100, 100, 100, 100), Type = Domain.AnnotationType.Area, Text = "area" }, new AnnotationInfo() { PageNumber = 0, Box = new Rectangle(200, 200, 80, 80), Type = Domain.AnnotationType.Ellipse, Text = "ellipse" } }; // Create annotation config AnnotationConfig config = new AnnotationConfig(); // Set storage path config.StoragePath = "storage"; // Create annotation handler AnnotationImageHandler annotator = new AnnotationImageHandler(config); // Create input file using (FileStream fs = new FileStream("input.pdf", FileMode.Open)) { // Export annotations and save result Stream result = annotator.ExportAnnotationsToDocument(fs, annotations); } ``` {{< /tab >}} {{< /tabs >}} ### New coding style {{< tabs "example2">}} {{< tab "C#" >}} ```csharp // Create list of annotations List annotations = new List() { new AreaAnnotation() { PageNumber = 0, Box = new Rectangle(100, 100, 100, 100), Message = "area" }, new EllipseAnnotation() { PageNumber = 0, Box = new Rectangle(200, 200, 80, 80), Message = "ellipse" } }; // Create annotator using (Annotator annotator = new Annotator("input.pdf")) { // Add annotations annotator.Add(annotations); // Save result to "result.pdf" annotator.Save("result.pdf", new SaveOptions()); } ``` {{< /tab >}} {{< /tabs >}} For more code snippets and specific use cases please refer to our [Developer Guide documentation]({{< ref "annotation/net/advanced-usage" >}}) or [GitHub](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET) samples and showcases.