Getting started with the Microsoft Information Protection .NET Wrapper

The Microsoft Information Protection SDK .NET Wrapper enables developers to integrate the Microsoft Purview Information Protection experience into their own applications and services. The SDK's classification, labeling, and protection features help ensure that information is classified, labeled, and protected no matter where it travels.

Install the managed wrapper and all dependencies from NuGet in Visual Studio.

Supported platforms

The Microsoft Information Protection .NET Wrapper is supported on the following .NET platforms:

  • .NET Standard 2.0 (and any consuming runtime, including .NET Framework 4.6.1+ and .NET 6 or later)

Installing the package

From the Package Manager Console in Visual Studio 2022 or later, install the package by running:

install-package Microsoft.InformationProtection.File

You don't need extra packages. The package includes all third-party libraries and copies them to the output folder on build.

Wrapper details

The .NET wrapper is a SWIG-generated managed wrapper. The wrapper uses compiled C++ libraries from the Microsoft Information Protection SDK. The C++ version of the SDK includes these DLLs.

Concept overlap

The C++ version of the SDK and the managed wrapper have a few fundamental differences.

  • The .NET wrapper doesn't require the use of Observers for async operations. It implements asynchronous operations by using the Task-based Asynchronous Pattern.
  • The .NET wrapper requires the delegates that are part of the C++ SDK: AuthDelegate and ConsentDelegate. It implements these delegates by using the interfaces IAuthDelegate and IConsentDelegate.

Next steps

Next, review Quickstart - Initialization for Microsoft Information Protection (MIP) SDK C# to get started on building a basic, MIP-enabled console application.