cloudinary-dotnet

cloudinary-dotnet is a library to easily integrate Cloudinary into your ASP.net MVC projects. The library allows you to easily upload files to your Cloudinary cloud, and at the same time provides some Url and Html helpers to access your images.

Uploading images

For uploading images you can use the Uploader class. It takes an AccountConfiguration instance (containing your cloud's name, api key and api secret) in the constructor. You can then use the the Upload to upload Images.

Example:

    var configuration = new AccountConfiguration("your cloud name",
                                                 "your api key",
                                                 "your secret");

	// Setup the uploader
    var uploader = new Uploader(configuration);

    string publicId = Path.GetFileNameWithoutExtension(filename);

    using(var stream =new FileStream(filename, FileMode.Open))
    {
	 	// Upload the file
        var uploadResult = uploader.Upload(new UploadInformation(filename, stream)
                            {
							 	// explicitly specify a public id (optional)
                                PublicId = publicId,
								// set the format, (default is jpg)
                                Format = "png",
								// Specify some eager transformations														 
                                Eager = new[]
                                            {
                                                new Transformation(240, 240),
                                                new Transformation(120, 360) { Crop = CropMode.Limit },
                                            }
                            });

		// Write some output info	
        Console.WriteLine("Version: {0}, PublicId {1}", uploadResult.Version, uploadResult.PublicId);
        Console.WriteLine("Url: {0}", uploadResult.Url);
    }
    Console.WriteLine("Successfully uploaded file");

Creating Cloudinary Urls

In order to easily access your Cloudinary images, there are some UrlHelper extension methods. The easiest way to work with them, is when you first initialize the AccountConfiguration statically. That way, you can use the helper methods without needing the specify the AccountConfiguration object over and over.

For example, in your application startup routine, put the following method:

    var configuration = new AccountConfiguration("your cloud name",
                                                 "your api key",
                                                 "your secret");

	AccountConfiguration.Initialize(configuration);

Once that is done, you can call the CloudinaryImage extension methods without providing

    <h3>Original</h3>
    <img src="@Url.CloudinaryImage("sample")" alt="sample"/> 

    <h3>Cropped 140x140</h3>
    <img src="@Url.CloudinaryImage("sample", new Transformation(140, 140) { Crop = CropMode.Crop })" alt="cropped"/>

TODO's

This library is far from done, here are some things that are still on the TODO list

• Correct creation of https urls
• Tests
• Creating a NuGet package, or creating a script that allows us to quickly generate new NuGet packages
• Uploading without reading the entire stream into memory