Saving Single Object¶

Blocking Method¶

Using Dictionary

Dictionary<string, object> result; 

result = Backendless.Data.Of( "TABLE-NAME" ).Save( Dictionary<string, object> );

Custom Class

public E Backendless.Data.Of<E>().Save( E entity );

Non-Blocking API¶

Using Dictionary

void Backendless.Data.Of( "TABLE-NAME" ).Save( Dictionary<string, object> entity, 
                                               AsyncCallback<Dictionary<string, object>> responder )

Custom Class

public void Backendless.Data.Of<E>().Save( E entity, AsyncCallback<E> responder )

where:

Argument	Description
`TABLE-NAME`	Name of the table where the object represented by `System.Collections.Generic.Dictionary` will be saved.
`E`	A .NET class of the data object to save.
`entity`	.NET object to persist, must be of type E or `System.Collections.Generic.Dictionary` (depending on the method used).
`responder`	a responder object which will receive a callback when the method successfully saves the object or if an error occurs. Applies to the non-blocking method only.

Return Value¶

The blocking method returns the saved object. The non-blocking call receives the return value through a callback executed on the AsyncCallback object.

Example¶

Dictionary<string, object> contact = new Dictionary<string, object>();
contact[ "name" ] = "Jack Daniels";
contact[ "age" ] = 147;
contact[ "phone" ] = "777-777-777";
contact[ "title" ] = "Favorites";

// save object synchronously
Dictionary<string, object> savedContact;
savedContact = Backendless.Data.Of( "Contact" ).Save( contact );

// save object asynchronously
AsyncCallback<Dictionary<string, object>> callback;
callback = new AsyncCallback<Dictionary<string, object>>(
  result =>
  {
    // object has been saved
  },

  fault =>
  {
    // server reported an error
  } );

Backendless.Data.Of( "Contact" ).Save( contact, callback );

Consider the following class.

using System;

namespace com.mbaas
{
  public class Contact
  {
    public String objectId { get; set; }
    public String Name { get; set; }
    public int Age { get; set; }
    public String Phone { get; set; }
    public String Title { get; set; }
  }
}

The following code saves a new instance of the Contact class:

Contact contact = new Contact();
contact.Name = "Jack Daniels";
contact.Age = 147;
contact.Phone = "777-777-777";
contact.Title = "Favorites";

// save object synchronously
Contact savedContact = Backendless.Data.Of<Contact>().Save( contact );

// save object asynchronously
AsyncCallback<Contact> callback = new AsyncCallback<Contact>(
    result =>
    {
      // object has been saved
    },

    fault =>
    {
      // server reported an error
    } );
Backendless.Data.Of<Contact>().Save( contact, callback );