INFO: Dynamically Add UserControls That Require Run-Time Licenses

When a UserControl contains one or more controls that require run-time licenses, the UserControl implicitly becomes a licensed control (requires run-time license). As a result, when you use the Controls.Add method to add the UserControl dynamically, you must precede it by a call to the Licenses.Add method and provide the license key for the call.

If you create a UserControl named, for example, MyProject.MyUserControl, that contains one or more controls that require a run-time license, MyProject.MyUserControl acquires a run-time license implicitly. Therefore, if you use the Controls.Add method to add MyProject.MyUserControl dynamically, or call Licenses.Add "MyProject.MyUserControl" without providing the license key, you get the following error message: To make this work, you must obtain MyProject.MyUserControl's license key on the development computer with the following code: Then, in the client code, you can use the following code to dynamically add MyProject.MyUserControl:

For additional information how to add controls dynamically, click the article number below to view the article in the Microsoft Knowledge Base: