Windows Developer Center > Downloads > Facebook SDK >  Version 3.0 Notes

Version 3.0 Notes

The main goals driving the release of version 3.0 were:

    • Provide better doc and samples
    • Provide support for Silverlight
    • Provide support for ASP.NET MVC
    • Provide improved support for WPF
    • Provide improved support for FBML (FBML Server Controls)
    • Provide a login control that can be used to replace the BasePage and/or MasterPage for Canvas Development
    • Improve out of the box support for Extended Permission Prompts
    • Refactor core source to improve maintainability and design
    • Fix known bugs

As part of this, we worked closely with the Concept Development Team at Microsoft to help design the Silverlight and WPF support. Also, after discussions with Microsoft it was decided that the namespaces and methods should be updated again to be more consistent with traditional .NET APIs. This will cause some breaking changes to everyone as they move to 3.0. But, the main goal is that we wanted to get it right this time so that this could become an officially supported client library. Microsoft is working with Facebook to get the toolkit identified as the officially supported library. The plan is to provide real-time support and updates to keep the toolkit in synch with the Facebook API.

Upgrading From Version 2.0/2.1 TO 3.0

Topic Version 2.1Version 3.0
Namespace Casing
facebook, facebook.webFacebook, Facebook.Web
Method Namesget(), getInfo()Get(), GetInfo()
Async Suffixget() (sync only)

Get() [Sync],

GetAsync() [Async]

Forms & ComponentsPart of facebook.dllPart of Facebook.Winforms.dll
ConnectToFacebook methodfacebook.API

Desktop only, in Facebook.Winforms

Other platforms leverage new Session objects to handle authentication.  This was kept for backward compatibility

Schema objects updated & Namespace Casingfacebook.SchemaFacebook.Schema
Method return typesSome incorrect return types were corrected in v3.0.  These will break upgraders, but are now correct types. 
Public SendRequest methods 

Added generic version and 1 overloaded method: 

public T SendRequest<T>(IDictionary<string, string> parameterDictionary, bool useSession)

API object constructor & Session objects refactoredAPI was instantiated with default constructorAPI now (requires) a FacebookSession subclass in constructor
Session objects & namespaceDidn't existIn Facebook.dll
Used to encapsulate the handshake between various applications
FacebookServiceWas in Facebook.dllMoved to Facebook.Winforms.dll (since this is really a Winform focused component that really just wraps the API class
JSON Helper methods exposed publiclyNot ExposedExposed Publicly

Version History

Version 1.1:

    • Added methods to FacebookService to wrap the Notifications.get Facebook API call. Added a new data object "Notifications" for wrapping the results.
    • Added Status and ProfileUpdateDate to the User object. Status contains the user's Facebook Status Message and time when it was updated. ProfileUpdateDate contains the date when the user last updated their Facebook profile.
    • Added SetFMBL method. Also correct GetRequestURL to correctly encode the format.
    • Added DirectFQLQuery. As designed on f8 wiki.
    • Fixed GetFriendsAppUsers. As designed on F8 wiki.
    • Fixed to add error handling to Country parsing in LocationParser
    • Added implementations of 2 notifications and 2 feeds APIs
    • Fixed parameter sorting for feeds APIs to work correctly
    • Change REST Call from GET to POST
    • Add GetLoggedInUser
    • Fix handling for no returned secret
    • Add overload to GetUserInfo that takes a Collection of user IDs

Version 1.2:

    • Refactored FacebookService
    • Added AsyncFacebookService
    • Refactored Parsers and Entities into their own directory and namespace
    • Added improved photo API
    • Added Canvas Base pages to Facebook.WebControls
    • Added Canvas samples to Facebook.WebControls
    • Added IFrame Ajax sample
    • Added IFrame Silverlight Example
    • Updated to new notifications API  **INTERFACE CHANGE**
    • Updated PublishStory and PublishAction interfaces **INTERFACE CHANGE**
    • Updated CreateAlbum interface to return created Album **INTERFACE CHANGE**
    • Added SetFBML override taking in userid
    • Added small and big picture URL and bitmap to photo and user
    • Added GetFriendsNonAppUsers method

Version 1.3:

  • Made lots of bug fixes
  • Added Support for .NET Compact Framework
  • Added Size on photo album
  • Added Master page versions of Canvas Base pages
  • Added Support for new request/invitation interface with multi_friend_selector *** INTERFACE CHANGE ***
  • Added Big/small pictures on group
  • Added Upload Photo returns a photo ID and album ID
  • Added Support for PublishTemplatizedAction
  • Added GetFBML
  • Added RefreshRefHandle
  • Added RefreshImgSrc
  • Added SetRefHandle
  • Added Session Timeout handling to IFrame base page

Version 1.4:

    • (skipped by request)

Version 1.5:

    • Created setup packages and .msi installer

Version 1.6:

    • Updated SetFBML() to support Facebook’s API change applied on 1/17/2008
    • Profile.SetFBML no longer accepts a single ‘markup’ parameter to hold profile, profile action and mobile profile FBML markup.  The new wrapper methods break the call into three parameters, profileFBML, profileActionFBML and mobileFBML.

Version 1.7:

    • Refactored code and fixed bugs.

Version 2.0:

    • Re-architected the API to create a lighter-weight wrapper around the API by using Linq2XSD to auto-generate the parsers and entity objects
    • Updated login logic to account for the new profile changes
    • Added new samples that work with the new API
    • Changed default value for RequireLogin on CanvasFBMLBasePage and CanvasFBMLMasterPage to be false instead of true
    • Changed parameters for liveMessage.send
    • Implemented feed.publishUserAction
    • Made API.sendRequest public
    • Renamed Api property on CanvasIFrameBasePage to ApiKey to follow conventions and avoid case-sensitivity issues
    • Various bug fixes

Version 2.1:

    • Added support for missing APIs
    • admin.getRestrictionInfo
    • admin.setRestrictionInfo
    • admin.banUsers
    • admin.unbanUsers
    • admin.getBannedUsers
    • auth.revokeExtendedPersmission
    • commnets.get
    • fbml.deleteCustomTags
    • fbml.getCustomTags
    • fbml.registerCustomTags
    • links.get
    • links.post
    • notes.create
    • notes.delete
    • notes.edit
    • notes.get
    • status.get
    • status.set
    • stream.addComment
    • stream.addLike
    • stream.get
    • stream.getComments
    • stream.getFilters
    • stream.publish
    • stream.remove
    • stream.removeComment
    • stream.removeLike
    • users.getStandardInfo
    • users.IsVerified
    • video.getUploadLimits
    • video.upload
    • Fixed the following bugs:
      10512,10705,11009,11215,11410,12026,12351,12386,12446,12590,12592,12593,12742,12818,13231
Page view tracker