.NET Integration

Prerequisites
Complete review of the Getting Started section.
Review of the Digging Deeper section.
A program registered to the ISB (for the purposes of this integration).
.NET Target Framework
Set your target to either .NET Framework 3.5 or .NET Framework 4.
The Client Profile target is not supported at this time.
If you set .NET Framework 4 as your target, you will need to add the following to your app.config
This is needed because we have chosen to maintain support .NET 3.5

.NET Integration Steps:

  1. Download the preconfigured database file for your program, as well as copy your program's Activity ID (assigned when you registered it to the ISB).
  2. Open Visual Studio and your solution.

  3. Click “Add Reference” as illustrated below and add the following (found in your Linxter SDK download):

    • LinxterSDK.dll
    • log4net.dll
    • System.Data.SQLite.dll

  4. Next, for each of those dlls, set their Copy Local property to True as illustrated below.
  5. Now, add the preconfigured database you downloaded for your Program to this project. Copy it into the project, click the “Refresh” icon, and then the “Show All Files”.
  6. Right click the “LinxterSDKDB” file and select “Include In Project”.
  7. Right click the “LinxterSDKDB” file again and select “Properties”. Change the “Build Action” to “Content” and “Copy to Output Directory” to “Copy if newer”
  8. Now you’re ready to start writing code. Depending on where in your code you want Linxter to reside, add these if using C#:
    using Linxter.SDK; using Linxter.Common.Entities; using Linxter.SDK.EventArgs; or these if using Visual Basic:
    Imports Linxter.SDK Imports Linxter.Common.Entities Imports Linxter.SDK.EventArgs

  9. The Linxter SDK class exposes three interfaces, all of which are implemented implicitly by the public API of the the LinxterSDK class. Implement based on what makes sense for your solution. As an example, if using C#:
    var sdk = new LinxterSDK(); or if using Visual Basic:
    Dim sdk = new LinxterSDK()

  10. You are done! Linxter has been integrated into your program. You can now begin to use the methods, properties and events of the Linxter API interfaces:
    • Registration
    • CommunicationChannel
    • Messaging

    11. Note: In your code, when you call the CreateMessage() or CreateMessages() method, you will need to include your program's ActivityID which was generated when you registered your program to the ISB.

    When you are ready to deploy your Linxter enabled application, be sure to review our Deployment guidelines.