【TeeChart .NET教程】（十七）設(shè)計時，運行時和授權(quán)要求

---

【下載TeeChart.Net最新版本】

（一）TeeChart運行時要求

本教程將介紹TeeChart應(yīng)用程序的運行時安裝的某些方面。

1.1 TeeChart運行時文件

您的TeeChart應(yīng)用程序需要與TeeChart.dll一起分發(fā)，如果您的應(yīng)用程序使用Steema.TeeChart.Languages命名空間，則需要與TeeChart.Languages.dll一起分發(fā)。您需要在此決定是否在本地安裝這些dll，例如，在應(yīng)用程序目錄下的bin目錄中，在AssemblyFolders注冊表項中注冊該文件夾，或者將它們安裝在全局程序集緩存（GAC）中。

（二）運行時編輯器幫助支持

TeeChart的編輯器可以在運行時實現(xiàn)，以使您的應(yīng)用程序用戶能夠修改圖表設(shè)置，TeeChart自己的設(shè)計時程序員幫助不會延伸到運行時，但您可以選擇在運行時添加自己的幫助文件，以便通過圖表編輯器上的“Help”按鈕打開。

2.1 Configuration

• 您的幫助文件應(yīng)該是chm格式（HTML Help v1）
• 安裝在以下注冊表位置時，helpfile應(yīng)該是運行時注冊的： [HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\HTML Help] "YourHelpfile.chm"="drive:\directory"

（三）TeeChart語言支持

TeeChart語言，即能夠以不同語言顯示TeeChart Editor和其他TeeChart對話框，目前僅支持運行時。

3.1 配置

要在運行時更改語言，您只需使用類似于以下內(nèi)容的代碼：

Steema.TeeChart.Languages.German.Activate（）;

3.2 示例

此處填充用于語言選擇的組合框：

private void Form1_Load(object sender, System.EventArgs e)  
        commander1.Chart = tChart1; 
        tChart1.Aspect.View3D = false; 
        line1.FillSampleValues(20); 
        comboBox1.Items.Add("Arabic"); 
        comboBox1.Items.Add("Brazilian"); 
        comboBox1.Items.Add("Catalan"); 
        comboBox1.Items.Add("Chinese Simple"); 
        comboBox1.Items.Add("Chinese Traditional"); 
        comboBox1.Items.Add("Danish"); 
        comboBox1.Items.Add("Dutch"); 
        comboBox1.Items.Add("English"); 
        comboBox1.Items.Add("Finnish"); 
        comboBox1.Items.Add("French"); 
        comboBox1.Items.Add("Galician"); 
        comboBox1.Items.Add("German"); 
        comboBox1.Items.Add("Hebrew"); 
        comboBox1.Items.Add("Hellenic"); 
        comboBox1.Items.Add("Hungarian"); 
        comboBox1.Items.Add("Indonesian"); 
        comboBox1.Items.Add("Italian"); 
        comboBox1.Items.Add("Japanese"); 
        comboBox1.Items.Add("Korean"); 
        comboBox1.Items.Add("Norwegian"); 
        comboBox1.Items.Add("Polish"); 
        comboBox1.Items.Add("Portuguese"); 
        comboBox1.Items.Add("Russian"); 
        comboBox1.Items.Add("Slovak"); 
        comboBox1.Items.Add("Slovene"); 
        comboBox1.Items.Add("Spanish"); 
        comboBox1.Items.Add("Swedish"); 
        comboBox1.Items.Add("Turkish"); 
        comboBox1.Items.Add("Ukranian"); 
        comboBox1.SelectedItem = "English"; 
 
 
private void comboBox1_SelectedIndexChanged(object sender, System.EventArgs e)  
        switch(comboBox1.SelectedIndex)  
            case 0: Steema.TeeChart.Languages.Arabic.Activate(); break; 
            case 1: Steema.TeeChart.Languages.Brazilian.Activate(); break; 
            case 2: Steema.TeeChart.Languages.Catalan.Activate(); break; 
            case 3: Steema.TeeChart.Languages.ChineseSimp.Activate(); break; 
            case 4: Steema.TeeChart.Languages.ChineseTrad.Activate(); break; 
            case 5: Steema.TeeChart.Languages.Danish.Activate(); break; 
            case 6: Steema.TeeChart.Languages.Dutch.Activate(); break; 
            case 7: Steema.TeeChart.Languages.English.Activate(); break; 
            case 8: Steema.TeeChart.Languages.Finnish.Activate(); break; 
            case 9: Steema.TeeChart.Languages.French.Activate(); break; 
            case 10: Steema.TeeChart.Languages.Galician.Activate(); break; 
            case 11: Steema.TeeChart.Languages.German.Activate(); break; 
            case 12: Steema.TeeChart.Languages.Hebrew.Activate(); break; 
            case 13: Steema.TeeChart.Languages.Hellenic.Activate(); break; 
            case 14: Steema.TeeChart.Languages.Hungarian.Activate(); break; 
            case 15: Steema.TeeChart.Languages.Indonesian.Activate(); break; 
            case 16: Steema.TeeChart.Languages.Italian.Activate(); break; 
            case 17: Steema.TeeChart.Languages.Japanese.Activate(); break; 
            case 18: Steema.TeeChart.Languages.Korean.Activate(); break; 
            case 19: Steema.TeeChart.Languages.Norwegian.Activate(); break; 
            case 20: Steema.TeeChart.Languages.Polish.Activate(); break; 
            case 21: Steema.TeeChart.Languages.Portuguese.Activate(); break; 
            case 22: Steema.TeeChart.Languages.Russian.Activate(); break; 
            case 23: Steema.TeeChart.Languages.Slovak.Activate(); break; 
            case 24: Steema.TeeChart.Languages.Slovene.Activate(); break; 
            case 25: Steema.TeeChart.Languages.Spanish.Activate(); break; 
            case 26: Steema.TeeChart.Languages.Swedish.Activate(); break; 
            case 27: Steema.TeeChart.Languages.Turkish.Activate(); break; 
            case 28: Steema.TeeChart.Languages.Ukrainian.Activate(); break; 

3.3 設(shè)計時間語言

TeeChart可以設(shè)置默認設(shè)計時語言，該語言將在TeeChart添加到表單時立即生效。在第一次打開圖表項目時，語言鍵中激活的語言將生效，或者可以通過圖表右鍵單擊菜單“Options”選項設(shè)置語言。

3.4 IE瀏覽器

[HKEY_LOCAL_MACHINE\SOFTWARE\Steema Software\TeeChart.NET] "Language"=dword:00000011 //Hex 11 is decimal 17 (Japanese)

（四）ASP.NET應(yīng)用程序支持

本節(jié)包含與ASP.NET WebForm應(yīng)用程序分發(fā)相關(guān)的信息。

4.1 配置

WebChart僅在WebChart的TempChart屬性設(shè)置為“文件”時才使用注冊表設(shè)置來查找臨時圖表存儲文件夾。如果WebChart的TempChart屬性設(shè)置為“Session”，則運行時服務(wù)器中不需要注冊表項。有關(guān)WebChart應(yīng)用程序配置的更多信息，請參閱教程9，。

4.2 當(dāng)TempChart設(shè)置為File時：

如果要將臨時文件寫入磁盤，則應(yīng)使用File設(shè)置。默認情況下，安裝TeeChart時，它會創(chuàng)建具有臨時文件位置和等效虛擬文件夾名稱的注冊表項，關(guān)鍵如下：

[HKEY_LOCAL_MACHINE \ SOFTWARE \ Steema Software \ TeeChart.NET] “VirtualShare”=“/ TeeChartForNET” “ShareFolder”=“C：\ Program Files \ Steema Software \ TeeChart for .NET v3 \ TeeChartForNET”

如果接受默認安裝位置，則上述設(shè)置將在標(biāo)準(zhǔn)英語語言機器中創(chuàng)建。TeeChartNET虛擬文件夾由TeeChart安裝程序創(chuàng)建。如果您創(chuàng)建必要的IIS虛擬共享位置以反映新的注冊表值，則可以更改這些注冊表設(shè)置。WebChart將文件保存到ShareFolder注冊表項中指定的文件夾下名為_Chart_tmp的文件夾中。TeeChart不會刪除臨時文件，但您可以自動包含一個實用程序作為Windows計劃任務(wù)。

（五）設(shè)計和運行時的授權(quán)設(shè)置

本節(jié)介紹了為符合TeeChart設(shè)計時和運行時授權(quán)體系結(jié)構(gòu)而要采取的配置元素和設(shè)置步驟。

5.1 說明

TeeChart使用基于Microsoft的System.Component.LicenseProvider類的授權(quán)控制。當(dāng)通過TeeChart安裝程序安裝TeeChart時，會添加一個注冊表授權(quán)密鑰，其可見部分可以在HKEY_LOCAL_MACHINE \ SOFTWARE \ Steema Software \ TeeChart.NET密鑰下看到："DesignKey"="Steema.TeeChart.TChart is a licensed component."

密鑰的存在以及相應(yīng)的“not-published”密鑰代碼允許在Visual Studio.NET的設(shè)計時使用TeeChart，并允許將密鑰編譯為運行時可執(zhí)行（.exe）和庫（.dll）文件，以便TeeChart.dll和TeeChart.languages.dll文件可以與已編譯的應(yīng)用程序一起分發(fā)，但不提供TeeChart選項作為安裝位置的設(shè)計時組件。

5.2 運營考慮因素

包含TChart，Chart或WebChart組件的項目必須包含Licenses.licx文件。當(dāng)向其添加任何圖表時，Visual Studio IDE會自動將該文件添加到TChart（Windows表單圖表）或WebChart（Web表單圖表）項目中。對于非設(shè)計時圖表應(yīng)用程序，例如，在運行時手動創(chuàng)建圖表 “Steema.TeeChart.Chart c = new Steema.TeeChart.Chart（）;” ，然后您必須手動將授權(quán)文件添加到項目，您可能使用的示例文件包含在Utils文件夾中。您可以通過在VS.NET解決方案資源管理器中選擇項目并單擊鼠標(biāo)右鍵單擊“ Add | AddExisting Item”與文件類型“All files”并選擇“Utils \ Licenses.Licx”。

5.3 在dll中使用TeeChart

如果已成功將帶有授權(quán)的TeeChart編譯到dll中，請注意，如果您在另一個應(yīng)用程序中使用該DLL，則需要確保將TeeChart授權(quán)添加到最終應(yīng)用程序的Licenses.licx文件中即使該應(yīng)用程序本身可能沒有直接引用TeeChart。如果您的最終用戶應(yīng)用程序不是在Visual Studio .NET中開發(fā)的，那么在最終編譯時不需要授權(quán)文件和授權(quán)本身。

如果您在具有開發(fā)人員授權(quán)的計算機上不會重復(fù)使用您的DLL的環(huán)境中工作，請確認重用是否可能屬于“插件使用”的范圍，如下一節(jié)所述，在插件dll中使用TeeChart。如果您認為您的程序集（使用TeeChart）需要由具有TeeChart類和方法知識的容器重新使用或需要引用程序集，但是在沒有TeeChart Developer License的計算機上請確認相關(guān)機器已獲得在設(shè)計時使用TeeChart的授權(quán)。某些分銷或團隊工作情況可能需要通過特殊授權(quán)條件來解決，Steema人員在info@st??eema.com可以幫助進行授權(quán)查詢。

5.4 在dll插件中使用TeeChart

標(biāo)準(zhǔn)版的TeeChart for .NET支持授權(quán)控制，以便在動態(tài)加載的插件中使用。該插件通常是一個包含TeeChart的程序集，可以在運行時由容器應(yīng)用程序使用NET的“Assembly.Load”方法或類似方法動態(tài)加載。為了允許容器應(yīng)用程序加載和運行TeeChart而不需要容器級別的licenses.licx文件，TeeChart提供了一個默認構(gòu)造函數(shù)的替代方法，編譯它的dll程序集將自身作為參數(shù)傳遞，并在該級別進行授權(quán)檢查不在容器應(yīng)用程序的DLL。請注意，容器應(yīng)用程序可能不會直接向TeeChart進行代碼調(diào)用。它可以打開并運行TeeChart dll，而dll本身就是自治的，可以自己調(diào)用TeeChart。允許從容器應(yīng)用程序進行Chart調(diào)用的規(guī)則的例外是，如果TeeChart的方法被可以在獨立接口中定義的方法“wrapped”（次要調(diào)用），可以修改此處描述的示例以包括此類調(diào)用。

插件

包含TeeChart的插件會在創(chuàng)建時加載TeeChart將其自身作為參數(shù)傳遞。只有在第一次打開TeeChart時才需要使用重載的構(gòu)造函數(shù)，以允許進行授權(quán)檢查。此后，可以通過常規(guī)手段使用TeeChart。使用的一個例子如下。在此示例中，TeeChart的“dummy”創(chuàng)建在表單創(chuàng)建時強制執(zhí)行初始授權(quán)檢查。

例：在此示例中，PluginShared.Factory是由宿主應(yīng)用程序引用的接口，它提供了一個名為“CreateForm”的方法。容納TeeChart的程序集實現(xiàn)了PluginShared.Factory，因此也提供了CreateForm方法，但它有自己的實現(xiàn)（在其中加載TeeChart）。主機識別CreateForm方法調(diào)用，而無需了解TeeChart特定程序集。請注意。容納TeeChart的程序集必須包含Licenses.licx文件，并在具有有效TeeChart開發(fā)人員授權(quán)的計算機上進行編譯。裝配外部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 
        } 
    } 
}

容器應(yīng)用程序（例如HostApp.exe），容器可能以下列方式裝載TeeChart外殼組件（dll）。HostApp引用發(fā)布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()); 
  } 
}

5.5 在Visual C ++ .NET中使用TeeChart

VC ++中的許可實現(xiàn)并不像其他.NET編程語言那樣透明。您可以按照Tim Adler在microsoft.public.dotnet.framework新聞組中描述的步驟成功實施VC ++項目的授權(quán)。

5.6 引用：

我的解決方法很簡單：創(chuàng)建一個新的解決方案，并在其中一個新的C＃項目，使用SAME應(yīng)用程序名稱作為您的C ++應(yīng)用程序。創(chuàng)建一個虛擬表單并將需要許可的每個組件放到此表單上?；蛘撸庉媗icenses.licx文件，自動生成以引用每個組件。然后構(gòu)建應(yīng)用程序。然后導(dǎo)航到調(diào)試目錄并將“* .licenses”文件復(fù)制到C ++應(yīng)用程序的基本目錄中。然后在Project Options->Linker->Input->Embed Managed Resource File setting of your C++ app，請參閱此授權(quán)文件。然后執(zhí)行“重建”。

5.7 Licenses.licx file

該文件是一個文本文件，至少應(yīng)包含一個文件或用作通用文件，以下三行：

Steema.TeeChart.Chart，TeeChart 
Steema.TeeChart.TChart，TeeChart 
Steema.TeeChart.Web.WebChart，TeeChart

內(nèi)容應(yīng)至少包括項目創(chuàng)建的類的名稱，通常是基于Windows窗體的項目的Steema.TeeChart.TChart，以及用于按代碼和Steema.TeeChart創(chuàng)建圖表的項目的Steema.TeeChart.Chart。 Web.WebChart用于包含TeeChart的WebChart組件的WebForm項目。 將圖表添加到表單NET時，會自動添加稍長的版本，也是正確的，包括程序集版本號和公鑰。

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

5.8 向舊的“non-licensed”項目添加授權(quán)支持

對于使用以前版本的TeeChart創(chuàng)建的表單應(yīng)用程序，授權(quán)文件不存在，您可以通過將“Tool”面板的“Steema”部分中的“Charts”拖動到任何文件來快速生成它。項目的表格，然后刪除它。新拖動的圖表會激發(fā)IDE添加Licenses.licx文件。

5.9 運行時分發(fā)

使用Licenses.licx文件編譯的項目的.exe或.dll可以作為運行時應(yīng)用程序與TeeChart.dll（以及TeeChart.Languages.dll文件，如果需要）一起分發(fā)，而無需任何TeeChart要安裝的運行時許可證文件或注冊表項。

5.10 授權(quán)問題疑難解答

錯誤情況是：Error message when compiling:

"Could not transform licenses file 'licenses.licx' into a binary resource."

可能的原因是開發(fā)授權(quán)注冊表項沒有到位。請檢查本章中描述的可見密鑰條目，以查看其中是否存在任何明顯的問題或遺漏。解決辦法可以是使用TeeChart安裝程序重新安裝TeeChart，安裝程序會設(shè)置注冊表項。如果問題仍然存在，請通過支持論壇聯(lián)系TeeChart支持。

License error when trying to run compiled (runtime) output application on machine without designkey installed.

檢查項目是否包含Licenses.licx文件。將圖表添加到表單時可能已自動添加，或者可能已手動添加。在任何一種情況下，請確認項目中的Licenses.licx文件是否為嵌入式資源。您需要激活“Show all files”以在項目的“Solution Explorer window”窗口中查看Licenses.licx的存在。另一個可能原因是licenses.licx文件內(nèi)容不正確。請檢查內(nèi)容是否反映了本章前一部分中描述的內(nèi)容。

（六）如何為設(shè)計時和運行時指定自定義主題

自定義主題是小* .xml文件，可以通過簡單的代碼行創(chuàng)建： tChart1.Export.Theme.Save（@ “C：\ Steema \ MyTheme.xml”）; 此自定義主題封裝了許多與圖形，畫筆和筆的顏色以及面板，軸，頁眉，頁腳，圖例等樣式相關(guān)的圖表圖形設(shè)置。創(chuàng)建后，這些主題可以顯示在圖表編輯器的主題選項卡中，名稱出現(xiàn)在那里作為文件的名稱。為了使圖表編輯器知道在哪里查找這些文件，有一個注冊表設(shè)置，它指定本地機器上的文件夾： [HKEY_LOCAL_MACHINE \ SOFTWARE \ Steema Software \ TeeChart.NET] “ThemeFolder”=“C：\ Program Files \ Steema Software \ TeeChart for .NET v3 \ Themes” 只需將自定義主題（* .xml文件）添加到此鍵中指定的文件夾，圖表編輯器就會讀取并顯示它們。

（七）TeeChart.Standard商業(yè)版的授權(quán)設(shè)置

說明：teechart.licenses可能包含在項目中，如啟動指南中所述：https ：//www.steema.com/linkIn/tnetstd_startup。使用授權(quán)文件：一旦包含在項目中并與其正確關(guān)聯(lián)（例如，通過添加為一個項目的嵌入式資源）然后該應(yīng)用程序在技術(shù)上準(zhǔn)備分發(fā)。