Skip to content

aflorenzan/parse-csharp

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Parse REST API for .NET

A simple C# wrapper for the Parse REST API, which you can learn about at https://parse.com/docs/rest. Parse has a .NET SDK, but unfortunately it "requires Visual Studio 2012 or Xamarin Studio and targets .NET 4.5 applications, Windows Store apps, Windows Phone 8 apps, and Xamarin.iOS 6.3+ or Xamarin.Android 4.7+ apps." If you want to target .NET 4.0 or lower, want to use VS2010 or lower, want to build for Windows Phone 7, or want to develop on a Windows 7 machine, you'll need to use the REST API.

Examples

(taken from https://raw.github.com/cfedersp/Parse-for-.NET for now)

Parse Object Creation

Parse.ParseClient myClient = new Parse.ParseClient("myappid", "mysecretkey");
Parse.ParseObject myObject = myClient.CreateObject("MyClass", new { foo = "bar" });
Dictionary<String,String> allObjects = myClient.GetObjectsWithQuery("MyClass", new { foo = "bar" });

Parse File Creation

ParseFile file = new ParseFile("c:\path\to\file.txt");

myClient.CreateFile(file);
Console.WriteLine(String.Format("File name: {0}", file.Name);
Console.WriteLine(String.Format("File url: {0}", file.Url);

Parse File Delete

localClient.DeleteFile(file);

File relational reference:

myObject["file"] = file;

Parse Querying using Constraints

These methods can be used to query Parse objects in a more complex way. Note that many of these can be combined, such as the less than/greater than constraints, to narrow down your results even further. The Parse-for.Net library relies on Parse's REST API to create the queries and as such any issues can be debugged by looking into the generated JSON to be passed to Parse and cross-checking it with the Query Constraints section of the REST API documentation.

Less Than Inclusive/Exclusive and Greater Than Inclusive/Exclusive

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    Price = new Constraint(lessThan: 1500),
    NegativeReviews = new Constraint(lessThanOrEqualTo: 2),
    Gigahertz = new Constraint(greaterThanOrEqualTo: 3),
    WarrantyYears = new Constraint(greaterThan: 0)
});

Not Equal To

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    Brand = new Constraint(notEqualTo: "HP")
});

In List

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    Brand = new Constraint(@in: new string[3] {"Apple", "Dell", "IBM"})
});

Not In List

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    Brand = new Constraint(notIn: new string[3] {"Apple", "Dell", "IBM"})
});

Value Does or Does Not Exist

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    PCIExpress = new Constraint(exists: true)
});

Select

Used to perform more complex queries across multiple Parse objects. The example below was created using Parse-for-.Net's Constraint class, based on the $select example on the following page: https://parse.com/docs/rest#queries-constraints

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("User", new
{
    Hometown = new Constraint(select: new
    {
        query = new
        {
            className = "Team",
            where = new 
            { 
                winPct = new Constraint(greaterThan: 0.5)
            }
        }
    })
});

Regex (Perl-based)

var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
var results = parseClient.GetObjectsWithQuery("Computer", new
{
    ManufacturerEmail = new Constraint(regex: @"\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,6}\b")
});

Regex Options

Note that 'i' and 'm' are the two possible values, which can also be concatenated to get both options. The option 'i' specifies that the regex will be case-insensitive while 'm' specifies that the regex should search multiple lines. More information can be found here: https://parse.com/docs/rest#queries-strings

 var parseClient = new Parse.ParseClient("myappid", "mysecretkey");
 var results = parseClient.GetObjectsWithQuery("Computer", new
 {
     ManufacturerEmail = new Constraint(regex: @"\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,6}\b", regexOptions: "im")
 });

Installation

Add this to your project using NuGet.

About

C# wrapper for the Parse REST API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 87.9%
  • XML 12.1%