TeeChart Pro ActiveX教程(十七):设计时,运行时和授权要求(下)

翻译|使用教程|编辑:王香|2019-01-31 10:16:32.000|阅读 37 次

概述:本节介绍了为符合TeeChart设计时和运行时授权体系结构而要采取的配置元素和设置步骤。

相关链接:

下载TeeChart Pro ActiveX最新版本

设计和运行时的授权设置

本节介绍了为符合TeeChart设计时和运行时授权体系结构而要采取的配置元素和设置步骤。

说明

TeeChart使用基于Microsoft的System.Component.LicenseProvider类的授权证控制。当通过TeeChart安装程序安装TeeChart时,会添加一个注册表授权证密钥,其可见部分可以在HKEY_LOCAL_MACHINE \ SOFTWARE \ Steema Software \ TeeChart.NET密钥下看到:

密钥的存在以及相应的“未发布”密钥代码允许在Visual Studio.NET的设计时使用TeeChart,并允许将密钥编译为运行时可执行(.exe)和库(.dll)文件,以便TeeChart.dll和TeeChart.languages.dll文件可以与已编译的应用程序一起分发,但不提供TeeChart选项作为安装位置的设计时组件。

运营考虑因素

包含TChart,Chart或WebChart组件的项目必须包含Licenses.licx文件。当向其添加任何图表时,Visual Studio IDE会自动将该文件添加到TChart(Windows表单图表)或WebChart(Web表单图表)项目中。对于非设计时图表应用程序,例如,在运行时手动创建图表 “Steema.TeeChart.Chart c = new Steema.TeeChart.Chart();” ,然后您必须手动将授权证文件添加到项目,您可能使用的示例文件包含在Utils文件夹中。您可以通过在VS.NET解决方案资源管理器中选择项目并单击鼠标右键单击“ 添加 ”来添加它 AddExisting Item ',文件类型为'All files',并选择'Utils \ Licenses.Licx'。

在dll中使用TeeChart

如果您已将带有授权证的TeeChart成功编译到dll中,请注意,如果您在另一个应用程序中使用该dll,则需要确保将TeeChart授权证行添加到最终应用程序的Licenses.licx文件中即使该应用程序本身可能没有直接引用TeeChart。如果最终用户应用程序不是在Visual Studio .NET中开发的,那么在最终编译时不需要授权证文件和授权证本身。

如果您在具有开发人员授权证的计算机上不会重复使用您的DLL的环境中工作,请确认重用是否可能属于“插件使用”的范围,如下一节所述,在插件dll中使用TeeChart。如果您认为您的程序集(使用TeeChart)需要由具有TeeChart类和方法知识的容器重新使用或需要引用程序集,但是在没有TeeChart Developer License的计算机上请确认相关机器已获得在设计时使用TeeChart的授权。某些分销或团队工作情况可能需要通过特殊授权条件来解决,Steema人员在info@st​​eema.com可以帮助进行授权证查询。

在插件dll中使用TeeChart

标准版的TeeChart for .NET支持授权控制,以便在动态加载的插件中使用。该插件通常是一个包含TeeChart的程序集,可以在运行时由容器应用程序使用NET的“Assembly.Load”方法或类似方法动态加载。要允许容器应用程序加载和运行TeeChart而不需要容器级别的licenses.licx文件,TeeChart提供了一个默认构造函数的替代方法,通过该构造函数,编译它的dll程序集将自身作为参数传递,并在该级别进行授权证检查不在容器应用程序的DLL。请注意,容器应用程序可能无法直接向TeeChart进行代码调用。它可以打开并运行TeeChart dll,而dll本身就是自治的,可以自己调用TeeChart。允许从容器应用程序进行Chart调用的规则的例外是,如果TeeChart的方法被可以在独立接口中定义的方法“包装”(次要调用)。可以修改此处描述的示例以包括此类调用。

插件

包含TeeChart的插件会在创建时加载TeeChart将其自身作为参数传递。只有在第一次打开TeeChart时才需要使用重载的构造函数,以允许进行授权证检查。此后,可以通过常规手段使用TeeChart。使用的一个例子如下。在此示例中,TeeChart的“虚拟”创建在表单创建时强制执行初始授权证检查。

例: 在此示例中,PluginShared.Factory是由宿主应用程序引用的接口,它提供了一个名为“CreateForm”的方法。容纳TeeChart的程序集实现了PluginShared.Factory,因此也提供了CreateForm方法,但它有自己的实现(在其中加载TeeChart)。主机识别CreateForm方法调用,而无需了解TeeChart特定程序集。

请注意。容纳TeeChart的程序集必须包含Licenses.licx文件,并在具有有效TeeChart开发人员授权证的计算机上进行编译。

装配外壳TeeChart(例如PluginWithTeeChart.dll)


Class:

namespace Plugin 
{ 
   public class FactoryImpl : PluginShared.Factory   
    { 
        public System.Windows.Forms.Form CreateForm() 
        { 
            try 
            { 
                return new PluginWithTeeChart.FormWithChart(); 
            } 
            catch (Exception e) 
            { 
                MessageBox.Show("failed to create plugin with error: " + e.ToString()); 
                return null; 
            } 
        } 
    } 
}

Form:

namespace PluginWithTeeChart 
{ 
    public partial class FormWithChart : Form 
    { 
        public FormWithChart() 
        { 
            //discardable Chart forces License check 
            Steema.TeeChart.TChart tempChart = new Steema.TeeChart.TChart(this); 
            tempChart = null; 
            InitializeComponent(); //<---- Normal application code. Could run here various TeeCharts without need for overloaded constructor 
        } 
    } 
}

容器应用程序(例如HostApp.exe)

容器可能按以下方式装载TeeChart外壳组件(dll)。HostApp引用发布CreateForm方法的公共接口Plugin.FactoryImpl非常重要。

void LoadTeeChartPlugin(string pluginName) 
{ 
  string pluginName = @".dll"; 
  try 
  { 
    Debug.WriteLine("Loading plugin assembly " + pluginName); 
 
    Assembly assembly = Assembly.LoadFrom(pluginName); 
 
    string factoryTypeName = "Plugin.FactoryImpl"; 
 
    Type t = assembly.GetType(factoryTypeName); 
    if (t == null) 
    { 
      MessageBox.Show("Type: " + factoryTypeName + " not found in plugin assembly"); 
      return; 
    } 
 
    PluginShared.Factory factory = (PluginShared.Factory)assembly.CreateInstance(t.ToString()); 
    System.Windows.Forms.Form f = factory.CreateForm(); 
    f.ShowDialog(); 
  } 
  catch (Exception ex) 
  { 
    MessageBox.Show(ex.ToString()); 
  } 
}

在Visual C ++ .NET中使用TeeChart

VC ++中的授权实现并不像其他.NET编程语言那样透明。您可以按照Tim Adler在microsoft.public.dotnet.framework新闻组中描述的步骤成功实施VC ++项目的授权。

引用:

“我的解决方法很简单:创建一个新的解决方案,并在其中一个新的C#项目,使用SAME应用程序名称作为您的C ++应用程序。创建一个虚拟表单并将需要授权的每个组件放到此表单上。或者,编辑licenses.licx文件,自动生成以引用每个组件。然后构建应用程序。然后导航到调试目录并将“* .licenses”文件复制到C ++应用程序的基本目录中。然后在项目选项下 - >链接器 - >输入 - >嵌入C ++应用程序的托管资源文件设置,请参阅此授权证文件。然后执行'重建'。“

Licenses.licx文件 该文件是一个文本文件,至少应包含一个文件或用作通用文件,以下三行:

 


Steema.TeeChart.Chart, TeeChart 
Steema.TeeChart.TChart, TeeChart 
Steema.TeeChart.Web.WebChart, TeeChart 

内容应至少包括项目创建的类的名称,通常是基于Windows窗体的项目的Steema.TeeChart.TChart,以及用于按代码和Steema.TeeChart创建图表的项目的Steema.TeeChart.Chart。 Web.WebChart用于包含TeeChart的WebChart组件的WebForm项目。 将图表添加到表单NET时,会自动添加稍长的版本,也是正确的,包括程序集版本号和公钥。


Steema.TeeChart.TChart, TeeChart, Version=1.1.1864.22788, Culture=neutral, PublicKeyToken=9c8126276c77bdb7

向旧的“非授权”项目添加授权证支持

请注意,对于使用以前版本的TeeChart创建的表单应用程序,授权证文件不存在,您可以通过将“工具”调板的“Steema”部分中的“图表”拖动到任何文件来快速生成它。项目的表格,然后删除它。新拖动的图表会激发IDE添加Licenses.licx文件。

运行时分发

使用Licenses.licx文件编译的项目的.exe或.dll可以作为运行时应用程序与TeeChart.dll(以及TeeChart.Languages.dll文件,如果需要)一起分发,而无需任何TeeChart要安装的运行时授权证文件或注册表项。

授权问题疑难解答

我们看到的可能的错误情况是: - 编译时出现错误消息:

“无法将授权证文件'licenses.licx'转换为二进制资源。” 可能的原因是开发授权证注册表项未到位。请检查本章中描述的可见密钥条目,以查看其中是否存在任何明显的问题或遗漏。解决问题的一个选项是使用TeeChart安装程序重新安装TeeChart,安装程序会设置注册表项。如果问题仍然存在,请通过支持论坛联系TeeChart支持。

- 尝试在未安装designkey的计算机上运行编译(运行时)输出应用程序时出现授权证错误。 检查项目是否包含Licenses.licx文件。将图表添加到表单时可能已自动添加,或者可能已手动添加。在任何一种情况下,请确认项目中的Licenses.licx文件是否为嵌入式资源。您需要激活“显示所有文件”以在项目的“解决方案资源管理器”窗口中查看Licenses.licx的存在。

- 问题的另一个可能原因是licenses.licx文件内容不正确。请检查内容是否反映了本章前一部分中描述的内容。

如何为设计时和运行时指定自定义主题

自定义主题是小* .xml文件,可以通过简单的代码行创建:

tChart1.Export.Theme.Save(@ “C:\ Steema \ MyTheme.xml”); 此自定义主题封装了许多与图形,画笔和笔的颜色以及面板,轴,页眉,页脚,图例等样式相关的图表图形设置。创建后,这些主题可以显示在图表编辑器的主题选项卡中,名称出现在那里作为文件的名称。为了使图表编辑器知道在哪里查找这些文件,有一个注册表设置,它指定本地机器上的文件夹:


[HKEY_LOCAL_MACHINE\SOFTWARE\Steema Software\TeeChart.NET]  
"ThemeFolder"="C:\Program Files\Steema Software\TeeChart for .NET v3\Themes" 

只需将自定义主题(* .xml文件)添加到此键中指定的文件夹,图表编辑器就会读取并显示它们。

TeeChart.Standard商业版的授权设置

TeeChart标准商业版通过nuget.org网站作为评估装配提供,功能齐全,在图表面上显示水印。注册授权证时,会向被授权方提供名为teechart.licenses的授权证文件。此文件可能包含在项目中以激活授权证并隐藏评估水印。

说明

teechart.licenses可能包含在项目中,如启动指南中所述:https ://www.steema.com/linkIn/tnetstd_startup

使用授权文件

一旦包含在项目中并与其正确关联(例如,添加为一个项目的嵌入式资源)然后该应用程序在技术上准备分发。

购买TeeChart Pro AciveX正版授权,请点击“咨询在线客服”哟!



标签:图表ActiveX图表控件teechart

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果

登录慧都网发表评论登录


暂无评论...

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
相关厂商
相关产品
TeeChart Pro ActiveX

交互性强的轻量级ActiveX图表控件,能高效生成多任务仪表板

在线客服 在线QQ 电话咨询
400-700-1020
在线客服系统
live chat