Facebook C# SDK

This SDK provides a light wrapper around the Facebook Graph API.

NOTE: This is an alpha release. If you encounter any issues, please file them here.

Getting Started

The easiest way to get started is to have Visual Studio. You can get a free copy of Visual C# 2010 Express Edition from Microsoft.

The instructions that follow will assume that are you using this version. The steps are very similar for other versions.

Once you have installed it and downloaded the source of the SDK, you will need to build the library. Open facebook/FacebookAPI.csproj. It may ask you to create a solution, in which case you can just use the default name. Right click on FacebookAPI in the Solution Explorer and choose Build. This shouldn't take very long. The SDK is ready to use. You can either build on top of this project, or use the DLL directly in another project.

There is a sample app included, which shows an example of the latter. Open examples/FacebookSampleApp.csproj. Again, it may ask you to create a solution. Go to the Solution Explorer and right click on References and choose Add a Reference. Navigate to the DLL you built and select it. Now build the project, and run it. You should see the string Mark Zuckerberg printed out, if everything worked.

Access Token

Most data accessible via the Graph API required an access token. This SDK does not include a method of getting a token from a user, as the best method will depend on what type of application is using it. A desktop application might show a popup browser window that loads the Facebook site, for example. You can read more about obtaining an access token in the authentication guide.

Calling the Graph API

First you instantiate an API object (passing in the token):

Facebook.FacebookAPI api = new Facebook.FacebookAPI(token);

If you pass in null then you will only be able to access public data. Then you make calls like:

JSONObject result = api.Get("/userid");

The JSONObject class provides a wrapper around JSON that allows for automatic type conversion. In particular, it can treat JSON as a Dictionary, Array, String, or Integer. So to get the name of the userid as a string you would do:

string name = result.Dictionary["name"].String;

The SDK also supports POST and DELETE requests, for writing data. For example to delete a comment once you have gotten its id you could do:

api.Delete("/comment_id");

To write a post on a user's wall you could do:

Dictionary<string, string> postArgs = new Dictionary<string, string>();
postArgs["message"] = "Hello, world!";
api.Post("/userid/feed", postArgs);

More information on the API itself can be found in the developer documentation.

Errors

Any errors in making Graph API calls cause a FacebookAPIException to be thrown.