In your code you just pass either the name of a file containing a valid license OR the raw XML contents of your license when creating any Controller object.

    string example = "C:\\ApiLicenses\\MyLicense.txt";

    HL7Controller obj = new HL7Controller(example);

Best Practices: We recommend that users declare the controller objects at the Form or Class level and keep them for use rather than constantly creating and destroying them.

using COREHL7FW;

using COREHL7FWDialogs;

private HL7Controller oController = null;

COREUtilities MyUtilities = new COREUtilities();

      public bool OpenMyController()

       {

          //In this example the License should be in a file in the installation folder

          string licenseFile = MyUtilities.ApplicationPath() + "MyLicense.txt";

          //Does the file exist, if not get it.

          if (!File.Exists(licenseFile))

           {

              if (!ActivateMyLicense())

               {

                  return false;

               }

           }

          //The license file exists. Now use it if needed

          if (oController == null)

           {

               oController = new HL7Controller(licenseFile);

              //After creation I can immediately check the LastException property to see

              //if anything went wrong

              //SO an if statement like this:

              //if (oController.LastException.HasException())

              //is the same as this below

              if (oController.HasException)

               {

                  //And this call:

                  //FormResults.ErrorMsgBox(oController.LastException.ExceptionMessage);

                  //is the same as this below

                   FormResults.ErrorMsgBox(oController.LastError);

                  return false;

               }

              //Now there was no exception. This means that licenseFile contains

              //a valid API License File FORMAT and was not a recipe for soup, etc.

              //BUT is the license actually usable???

              if (!oController.LicenseIsRunnable)

               {

                   FormResults.ErrorMsgBox("The license is not runnable for some reason!");

                  return false;

               }

              return true;

           }

          else

           {

              //The controller is instantiated already. Let's test our license;

              if (!oController.LicenseIsRunnable)

               {

                  //Ok, maybe the problem has been fixed since we last called it

                  //so let's refresh it

                  //With the CORE HL7 API you can create the controller objects using

                  //a STRING value which is EITHER a file containing the license OR

                  //simply a blob of text which is the license value.

                  string licenseValue = File.ReadAllText(licenseFile);

                   oController = new HL7Controller(licenseValue);

                  //And check it again.

                  if (oController.LicenseIsRunnable)

                   {

                      return true;

                   }

                   FormResults.ErrorMsgBox("The license is not runnable for some reason!");

                  return false;

               }

              //The license is fine

              return true;

           }

       }