ComponentOne中文技术文档
Page tree
Skip to end of metadata
Go to start of metadata

入门
如果您是刚接触
Chart for
WinForms,那么从以下主题开始:

  • WinForms图表快速入门(27页) - 特殊的2D图表 (80

    页)
  • 创建2D图表的设计

    时工具(118页)
  • 图表区域和绘制区

    域对象(page 204) - WinForms图表指南(268页)





使用 ComponentOne Chart for WinForms 可以有效地创建具有
专业外观的 2D 和 3D 图表.使用 Visual Studio .NET 内置的最新技术,C1Chart 可以完全兼容.NET Frameworks 的 2.0,3.5,4.0 版本.
ComponentOne 完全封装了图表组件的底层复杂性,从而使开发人员只需重点关注应用程序中更重要的部分-特定的功能业务。
ComponentOne Chart™ for WinForms 含有两个在 Microsoft
Visual Studio .NET 中创建 2D 和 3D 图表的图表控件:C1Chart 和
C1Chart3D.其中 C1Chart 控件是一个二维的图表控件,它允许您为任何图表类型应用程序创建多种类型的动态 2D 图表. C1Chart3D 是一个三维的图表控件,它用来创建三维表面,三维条形图,三维散点图表,四维条形图,四维表面图表。
ComponentOne Chart™ for WinForms 的全面和详细的文档帮助您在创建 C1Chart 和 C1Chart3D 图表时更加的得心应手.为了更加方便您的阅读, ComponentOne Chart™ for WinForms 的帮助文档有两部分:

  • C1Chart2D 帮助– 介绍有关 C1Chart 控件的文档.
  • C1Chart3D 帮助– 介绍有关 C1Chart3D 控件的文档.

为了让您在任何图表类型应用程序中创建具有漂亮的外观,理想的性能的图表. ComponentOne Chart for WinForms 给您提供了以下的功能特性:
超过 80 种的 2D 和 3D 图表类型,灵活的可以自定义的图表元素,零
代码的交互式设计器,增强的视觉效果(光效果和阴影等),终端用户交互,高级鼠标跟踪能力. 关于 ComponentOne Chart for WinForms 中最新新增的功能,请访问
Chart for WinForms中的新功能.

 安装 Chart for WinForms

本章节介绍 Chart for WinForms 的安装文件和系统要求.并且也介绍了如何安装 ComponentOne 产品的一个演示版本,还有如何卸载 Chart for WinForms.

 Chart for WinForms 安装文件

ComponentOne Chart for WinForms 安装程序会创建以下的目录: C:\Program Files\ComponentOne\Studio for Winforms.该目录含有以下的子目录:
Bin 含有ComponentOne的所有的二进制文件的拷贝(DLL,EXE).
H2Help 包含所有Chart for WinForms控件的在线文档.
C1Chart 包含Chart for WinForms产品的相关文件(至少含有readme.txt).
ComponentOne Studio for WinForms 帮助安装程序完整地安装了 Microsoft Help 2.0 和 Microsoft Help Viewer help,它们被安装在 C:\Program Files\ComponentOne\Studio for
WinForms 目录,并含有以下的目录:
H2Help 含有所有的Studio组件的Microsoft Help 2.0完整的文档.
HelpViewer 含有所有的Studio组件的Microsoft Help Viewer Visual Studio
2010完整的文档.
示例产品的实例程序默认安装在 ComponentOne Samples目录下. ComponentOne Samples的
目录在 Windows XP 和 Windows Vista 的机器上是有略微的不同的:
Windows XP 下的路径: C:\Documents and Settings\<username>\My
Documents\ComponentOne Samples
Windows Vista 下的路径: C:\Users\<username>\Documents\ComponentOne Samples
ComponentOne Samples目录含有以下的子目录:
Common 提供供大部分的示例程序使用的帮助和数据文件.
C1Chart 提供Chart for WinForms的示例和指南.
可以使用ComponentOne Sample Explorer来访问示例.在您的电脑桌面上,点击Start菜单, 然后依次点击ComponentOne | Studio for WinForms| Samples |Chart Samples.

 系统要求:

含有以下的系统要求:
Operating Systems: Windows 7
Windows® 2000
Windows Server® 2003
Windows Server 2008
Windows XP SP2
Windows Vista™
Environments: .NET Framework 2.0 或更高级版本. C# .NET Visual Basic .NET
Disc Drive: 如果从CD安装，那么需要CD或者DVD-ROM

 安装演示版本

如果您想试用ComponentOne Chart for WinForms,但是又没有一个序列号.按照以下步骤完成安装向导并使用默认的序列号.
我们的产品在非注册(演示版)和注册(付费版)两个版本中的唯一的区别是注册版会标记您编译的每一个应用程序,然后在您的程序运行时不会弹出我们的 ComponentOne 提示对话框.

 卸载 Chart for WinForms

如果您需要卸载ComponentOne Chart for WinForms,那么完成以下步骤:

  1. 打开控制面板,并选择添加或删除程序(在Windows 7/vista中是程序和特性).
  2. 选择ComponentOne Studio for WinForms,并点击Remove按钮.
  3. 点击Yes来删除程序.


 ComponentOne 终端用户许可协议

所有的ComponentOne许可信息,包括ComponentOne终端用户许可协议, ComponentOne 授权模型,和常见的许可问题.

 许可常见问题和解答

本章节介绍了许可在的主要技术特性.这可能帮助您理解和解决在.NET 和 ASP.NET 中使用
ComponentOne 时会碰到的一些许可问题.

 什么是许可?

许可是一种通过保证用户有权使用软件产品,来达到保护知识产权的目的的机制.
许可不仅仅是用来防止非法销售软件产品.许多软件厂商,包括 ComponentOne 在内,使用许可来让潜在用户在决定是否购买产品之前先测试产品是否满足他们的需求.
离开了许可,这种形式的分发对生产商是不实际的,同时对用户也很不方便.生产商将不得不采取以下两种方式之一:分发一个仅有有限功能的评估版,或者将管理软件许可的责任转嫁给终端用户,用户很容易忘记他们正在使用的是一个评估板本,而他们并没有购买.

 许可如何工作?

ComponentOne 使用的授权模型基于 Microsoft 提供的行业标准.它适用在任何的组件上.
注意: Compact Framework 组件相比于其它的 ComponentOne 组件,因为平台差异而使用了一种稍微不同的运行时许可机制.
当用户购买了产品以后,他会收到一个安装程序和一个序列号.用户在安装过程中会被提示
输入保存在系统中的序列号(用户还可以通过点击任何ComponentOne产品的About Box菜单中的 License 按钮来输入序列号,或者也可以通过重新运行安装向导并在许可对话框中输入序列号来完成).
当一个许可过的组件被添加到一个窗体或者 Web 页面中时, Visual Studio 会从新创建的组件中获取版本和许可信息.当 Visual Studio 查询时,组件会查找存储在系统中的许可信息,并且生成一个运行时的许可和版本信息,同时, Visual Studio 会把这些信息存储在以下两个文件中.

  • 一个含有真正的运行时许可的程序集资源文件.
  • 一个"licenses.licx"文件,它含有已许可的组件的强命名和版本信息.

Microsoft Visual Studio 会自动添加这两个文件到工程中去.
在 WinForms 和 ASP.NET 1.x 程序中,运行时许可会由 Visual Studio 将其作为嵌入资源保存到包含控件或者组件的程序集中.在 ASP.NET 2.x 应用程序中,运行时许可信息可能被当做嵌入资源存储在 App_Licenses.dll 程序集中,该程序集用来保存所有本应用程序中寄宿在
WebForms 上的所有控件的运行时许可.所以,App_licenses.dll 程序集应该总是随着应用程序一起部署.
licenses.licx 文件是一个含有所有应用程序中用到的已许可的组件的强命名和版本信息的简单的文本文件.每次使用 Visual Studio 进行重新编译资源时,该文本被读取,来给一系列的控件提供运行时许可,并将许可嵌入到适当的程序集资源中.请注意在该文件中编辑或者添加一行能够导致 Visual Studio 给其它控件添加运行时许可.
请注意licenses.licx文件通常不出现在Solution Explorer中,但是当您点击Solution Explorer 中的 Show All Files 按钮后它就会出现.或者您也可以通过在 Visual Studio 的主菜单中,从
Project 菜单中选择 Show All Files 来显示该文件.
之后,当控件在运行时被创建时,它从适当的程序集资源中获得运行时许可.该资源在设计时创建,并能够决定是否简单地接受运行时许可,或者抛出一个异常并导致失败,或者给用户提示一些信息来告诉他们用到的控件没有被许可.
所有的 ComponentOne 产品都被设计成当产品没有许可时就弹出许可信息.而不会抛出异常或者阻止应用程序的执行.

 常见场景

以下的部分描述了您可能会碰到的许可问题的场景.
 在设计时创建控件
这是最常见同时也是最简单的场景:用户给窗体添加了一个或者多个控件,同时许可信息被存储在 licenses.licx 文件中,然后,控件能够工作.
请注意这种机制在Windows Forms 和 Web Forms (ASP.NET)工程中完全一致.
 在运行时创建控件
这也是相当常见的场景.您不需要在窗体中含有控件的一个实例,但是您可能想在运行时创建一个或者多个控件的实例.
在这种场景下,工程将不会含有Licenses.licx文件(或者文件中将不会含有该控件对应的运行时许可),所以许可将会失败.
为了修正这个问题,在工程中给窗体添加一个控件的实例.这会导致 licenses.licx 文件被同步添加,同时一切都会按照预期工作(控件的实例可以在 licenses.licx 文件创建处理后从窗体上删
除).
添加一个控件的实例到窗体上,之后再将其删除,这只是一种在 licenses.licx 文件中添加一行关于控件强签名的简单方式.您也可以通过使用记事本或者 Visual Studio 本身来打开文件并添加对应的行.当 Visual Studio 创建应用程序资源时,会查询控件,并将其运行时许可添加到适当的的程序集资源中.
 从许可过的组件中继承
当一个继承自许可过的控件的控件被创建时,仍然需要在窗体中保存许可信息.可以通过以下两个方式完成:

  • 给控件添加一个LicenseProvider属性.

这会让派生组件类被认为是认证过的.Visual Studio会创建并管理licenses.licx文件,然后基类会照常处理许可过程,而不需要做任何的附件工作.例如:

[LicenseProvider(typeof(LicenseProvider))]


class MyGrid: C1.Win.C1FlexGrid.C1FlexGrid
{
// ...
}


  • 在窗体上添加一个基类组件的实例

这会导致在 licenses.licx 文件中嵌入许可信息.类似于前一个场景,基类组件会查找并使用许可.这个额外的基类组件可以在许可被添加到 licenses.licx 文件中后删除掉.
请注意,C1 许可不会在以下场景下接受一个派生组件的运行时许可:如果运行时许可没有被嵌入在和派生类定义的相同程序集中,并且该程序集是一个DLL.这个制限是为了防止在没有设计时许可的情况下,一个派生控件类程序集被用在另外一个程序集中.如果您创建了一个这样的程序集,那么您需要做前述动作中的一个来在运行时创建一个组件.
 在控制台中使用许可过的控件
当构建控制台应用程序时,没有窗体可以用来添加控件,所以 Visual Studio 不会创建 licenses.licx 文件.
在这种情况下,创建一个Windows Forms 应用程序,并添加所有需要许可的组件到一个窗体
中.然后关闭该Windows Forms 应用程序,并将 licenses.licx 文件拷贝到控制台应用程序的工程
中.
请确认 licenses.licx 文件在工程中是嵌入资源.为了做到这一点,在 Solution Explorer 窗体中
的 licenses.licx 文件上右键,并选择 Properties.在属性窗口中,将 Build Action 属性设置为
Embedded Resource.
 在 Visual C++应用程序中使用许可过的控件
在 VC++ 2003 中有一个问题,就是licenses.licx 文件在构建过程中会被忽略.所以 VC++应用程序中不含有许可的信息.
为了修正这个问题,需要做额外的步骤来编译许可资源并将它们链接到工程中.如下所述:

  1. 像通常一样构建C++应用程序,这样会创建一个exe文件,还有含有许可信息的 licenses.licx文件.
  2. 拷贝licenses.licx文件到目标目录(Debug或者Release).
  3. 拷贝C1Lc.exe工具和许可过的DLL到目标目录(不要使用标准的Lc.exe,它有Bug).
  4. 使用C1Lc.exe工具来编译licenses.licx文件,命令的形式如下:

c1lc /target:MyApp.exe /complist:licenses.licx /i:C1.Win.C1FlexGrid.dll

  1. 将许可链接到工程.为了做到这一步.回到Visual Studio中,在工程上右键点击,选择属性.然后进入Linker/Commond Line选项.然后输入以下命令:
  2. /ASSEMBLYRESOURCE:Debug\MyApp.exe.licenses
  3. 重新编译可执行文件,这样就会在应用程序中包含许可信息.

 在自动测试中使用许可过的组件
动态装载程序集的自动测试产品可能会导致弹出许可对话框.这是预期行为,因为通常测试程序不会含有必须的许可信息,并且没有简单的方式添加它.
这可以通过在含有或继承自 ComponentOne 控件的程序集的 AssemblyConfiguration 属性中添加 C1CheckForDesignLicenseAtRuntime 字符串来解决.该属性指定 ComponentOne 控件在运行时使用设计时的许可信息.
例如:

#if AUTOMATED_TESTING

[AssemblyConfiguration("C1CheckForDesignLicenseAtRuntime")]


#endif public class MyDerivedControl : C1LicensedControl {
// ...
}


请注意 AssemblyConfiguration 字符串可以在给定的字符串之前或者之后含有附件的文字.
所以 AssemblyConfiguration 字符串也可以用作其他用途.例如:

[AssemblyConfiguration("C1CheckForDesignLicenseAtRuntime,BetaVersion")]


这个方法必须用在前述场景中.它需要在测试机器上安装一个设计时许可.给其他机器分发或者安装许可是对最终用户授权协议的侵犯.


 移动应用程序上的常见场景

下面的主题描述了您在移动应用程序中可能会遇到的许可场景.
 升级或者重建许可
如果您重建了您的订阅,那么需要安装新的许可.
如果一个移动控件是通过 Studio 订阅来进行许可的,那么打开一个ASP.NET 控件或者.NET
Windows 窗体控件的 About Box 来更新您的许可,这通过点击 License 按钮并输入序列号来完
成.
如果一个移动控件是通过 Studio for Mobile Devices 订阅来进行许可的,那么打开一个 1.x 版本的移动控件的 About Box 或者运行安装程序来输入序列号.目前, 2.x 版本的移动控件不能
从 About Box 中进行许可或者注册.所以,必须通过另外一个控件或者安装程序来进行许可动作.
通过安装程序来进行 2.X 移动控件的许可
为了在 Studio for Mobile Devices 2.0 安装程序中输入序列号(许可).需要进行以下步骤:

  1. 运行ComponentOne Studio for Mobile Devices 2.0安装程序.
  2. 按照安装过程中的描述,在提示输入时输入序列号.

在一些情况下安装程序可能不会提示.如果您已经安装了一个合法的许可.或者您在安装一个已经安装过的控件版本(维护模式),这样您将不会被提示来输入序列号.如果您想在维护模式中输入一个序列号.那么您首先需要进行卸载.一旦您完成卸载,重新运行按照程序.
如果您还是在安装程序的安装过程中没有被提示输入序列号,那么您一定已经安装过了一个合法的许可.如果您还是想输入一个新的序列号,那么删除旧的序列号并重新运行安装程序.这里有一个帮助您删除旧的序列号的工具,如下所述.
许可删除器
许可删除器会查找您机器中以下产品的许可信息: Studio Enterprise, Studio for Mobile
Devices, 和 individual Studio Mobile.所有找到的许可会在一个列表中显示,这样方便您选择您想要删除的许可.为了在许可删除器中删除一个 Studio for Mobile Devices 许可.按照以下步骤进行:

  1. 解压缩并运行C1LicBomb.exe.
  2. 您将会看到一个显示了您机器上所有的安装过许可的应用程序的列表.如果您在列

表中同时看到了Studio Enterprise和Studio for Mobile devices,选择你看到的其中一个.如果您希望为Studio for Mobile Devices重新输入的新的序列号，不是一个Studio
Enterprise序列号,您需要重新输入您的Studio Enterprise序列号.但是这可以通过除了Mobile Studio About Boxes之外的所有C1chart控件的About Boxes来完成.

  1. 选择任何您想删除的许可,然后点击Remove Selected Licenses按钮
  2. 您将会被询问是否确认要删除许可,当该询问对话框出现时,点击OK.
  3. 删除过程中也会出现一个对话框来提示您某一个特定的许可已经被成功删除,点击

OK按钮来继续进行删除动作.

  1. 现在,您可以关闭许可删除器,然后运行您的Studio for Mobile Devices安装程序,并在安装过程中输入您的序列号.

按照安装过程中的步骤,当被提示时输入您的序列号.然后 ComponentOne Studio for Mobile
Devices 将会在您的机器中被许可.
 重建许可后更新您的工程
一旦您安装了新的许可,那么每一个工程都应该进行更新,从而能够使用新控件.重新编译控件是不够的.还需要控件重新生成嵌入在它的 SupportInfo 属性中的许可信息.为了做到这一点, 必须要强制Visual Studio 更新存储在窗体中的控件属性.最简单的做到这一点的方法是通过简单地更改一个属性.最简单的选择是切换一个布尔属性,例如 Visible 属性.然后切换它的值到原始值. 这不会导致控件配置的任何改变或者有任何的副作用.但是这会强制 IDE 更新 SupportInfo 并嵌入最新的运行时许可.
 在运行时安装一个移动控件
当移动控件在设计时没有被添加到窗体中,而在运行时被创建时,它表现得跟其它的 ComponentOne 控件没有差别.因为 IDE 在这种情况下没有机会自己获取运行时许可的信息,所以需要强制 IDE 包含一个许可信息.为了做到这一点,在动态创建的组件被创建之前,至少在含有窗体的程序集中包含一个控件的实例.一旦一个相同类型的控件被许可了,窗体上所有相同类型的控件都被认为是许可的.

 疑难排解

我们非常用心地让许可机制尽可能的简单明了.但是因为一些原因问题还是会出现.
下面的章节描述了最常见的场景和它们的解决方案
 我有一个许可过的 ComponentOne 控件版本的产品,但是当我运行工程时仍会出现闪屏
如果出现了这种情况,那么可能是工程中的licenses.licx文件出了问题.它可能不存在,或者含有错误的信息,或者没有被正确的配置.
首先,尝试一次完全的重新编译(Visual Studio 中的 Build 菜单中的 Rebuild All 子菜单).这通常会重新编译正确的许可资源.
如果这也失败了,尝试以下的动作:

  1. 打开受影响的工程.
  2. 选择一个更新过的控件的一个实例
  3. 在Visual Studio Properties窗口,改动任何的一个属性.改变了哪一个属性是没有关系的, 因为您可以把它的值重新修改为原有值.
  4. 使用Rebuild All(而不是Rebuild)菜单来重新编译工程.然后运行工程.

可选方案1,按照以下的步骤:

  1. 打开一个新的Visual Studio.NET工程.
  2. 添加一个更新过的控件到窗体上.
  3. 编译并运行工程.
  4. 打开新工程的licenses.licx文件.
  5. 拷贝以更新过的组件的命名空间(例如,C1.Win.C1Report)开头的信息行,并以公钥标记结束.
  6. 打开现有的不正确的工程.
  7. 打开新工程的licenses.licx文件.
  8. 将从第5步中得到的信息行拷贝到这个文件中(使用新的信息替换旧信息).
  9. 使用Rebuild All(而不是Rebuild)菜单来重新编译工程.然后运行工程.

可选方案2,按照以下的步骤:

  1. 打开受影响的工程.
  2. 从工程中删除licenses.licx 文件.
  3. 在窗体上添加一个更新过的控件的实例.
  4. 重新编译并运行工程,这次闪屏不会再出现.
  5. 在窗体上删除第2步新添加的控件.

如果需要,可以多次尝试可选方案.如果还是没有解决问题,请检查下您是不是在代码中而不是在设计时创建了一个控件.如果是的话,您必须在 licenses.licx 文件中添加对应的条目(参考
http://helpcentral.componentone.com/PrintableView.aspx?ID=1886 来获取更多的信息).同时如果您的项目是一个网站,而不是 ASP.NET web 应用程序.请在 licenses.licx 文件上右键点击,并且在上下文菜单中选择"Build Runtime Licenses".
 我在我的 Web 服务器上有一个许可过的 ComponentOne 控件版本的产品,但是表现的像没有许可一样
没有必要在被当做服务器而不是开发使用的机器上安装任何的许可.
控件必须在开发机器上被许可,这样当工程编译时许可信息将会被保存到可执行文件中(.exe 或者.dll).在这之后,应用程序可以被部署到包含服务器在内的任何机器上.
对于 ASP.NET 2.x 应用程序,请确保 App_Licenses.dll 程序集在开发的应用程序被部署到 web 服务器的 bin 目录时被创建.
如果您的 ASP.NET 应用程序以组合许可控件形式使用 WinForms 用户控件.运行时许可信息被嵌入在WinForms 用户控件程序集中.您必须在嵌入的许可过的控件被更新时重新编译并更新用户控件.
 我下载了一个许可过的控件的最新版本,但是当我编译我的工程时出现了闪屏
请先检查序列号是否还有效.如果您在一年前对控件进行的许可动作.那么您的分发很可能已经失效.在这这种情况下,您有两种选择:
可选方案1—重建您的分发并获得一个新的序列号
如果您选择这样做,那么您会获得一个新的用来对控件进行许可的序列号(从安装工具或者直接从 About Box 获取).
新的分发将会授权您获取所有最新的产品更新。
可选方案2—继续使用您已有的控件
分发过期,但是产品没有过期.您可以在您的分发失效时继续使用您收到或者下载的组件.

 技术支持

葡萄城遵循"专业服务，快速响应"的服务理念，向客户提供与葡萄城控件产品相关的控件选型、试用支持、产品使用金牌服务、项目部署等全程服务，为用户的控件使用保驾护航。
更多详情，请参见葡萄城控件官方网站有关技术服务的介绍。

 再发行文件

ComponentOne Chart for WinForms 基于 ComponentOne LLC 开发和发布.你可以
Microsoft Visual Studio或者任何支持用户使用和集成控件的开发环境里使用它来开发应用程序.
您还可以在这种场景中免费的分发以下的可再分发文件:开发在网络的客户端/工作站端中运行在单独一个 CPU 上的应用程序.
C1.Win.C1Chart.2.dll
C1.Win.C1Chart3D.2.dll C1.CF.C1Chart.2.dll (Chart for Mobile Devices) C1.Win.C1Chart.4.dll C1.Win.C1Chart3D.4.dll

 关于本文档

致谢
Microsoft, Windows, Windows Vista, and Visual Studio 是注册商标或者微软公司在美国和/
或者其他国家的商标. ComponentOne
如果您有关于新特性或者控件的任何建议.请给我们致电或者使用以下地址写信:
西安葡萄城
葡萄城成立于 1980 年，是全球最大的控件提供商、微软公司认证的金牌合作伙伴和 Visual Studio Industry Partner 计划合作伙伴。葡萄城致力于为全球客户提供先进的控件产品和服务，其开发的多代控件产品在日本和欧美市场占据领先地位，在全球拥有 850 多名员工和数十万用户。
更多信息，请访问葡萄城控件产品网站：[ |http://www.gcpowertools.com.cn/]{+}http://www.gcpowertools.com.cn+。
在新浪微博关注 {+}http://e.weibo.com/powertools+[ |http://e.weibo.com/powertools]，可了解葡萄城控件最新动态。

 命名空间

命名空间是用来组织在一个程序集中定义的对象的.程序集可以含有多个命名空间,而且命名空间允许嵌套定义.
命名空间防止歧义产生,并在诸如类库之类的大量使用对象的程序中简化了引用.
ComponentOne Windows产品总的命名空间是C1.Win.ComponentOne Web-based产品总的命
名空间是C1.Web. C1Chart控件的命名空间是C1.Win.C1Chart,同时其Web程序集的命名空间是C1.Web.C1WebChart.下述的代码片段展示了如何在一个类中使用完整的命名空间来声明一
个C1Chart控件.

  • Visual Basic


Dim chart As C1.Win.C1Chart.C1Chart

  • C#


C1.Win.C1Chart.C1Chart chart;
命名空间有时候会导致一种叫做命名空间污染的问题.当开发人员在开发类库时使用了另一个使用了相同命名空间的库时会出现这种问题.与现有组件的这种冲突有时被称为命名冲突.
例如,一个名为 ChartLabels 的类被创建出来.它能够在工程内部无限制地被使用.但是
C1Chart 程序集也包含了一个名为 ChartLabels 的实现类.所以,当这两个 C1Chart 类被用在同
一工程中,必须适用完全命名空间来指定一个确定的引用.如果引用不唯一,那么 Visual
Studio .NET 会产生一个错误并提示命名有歧义. 完全有效名称是那些以对象被定义的程序集的命名空间名字开头的对象引用.在其它工程中
定义的对象在添加了对象所在程序集的引用后就可以使用(通过在工程菜单中选择添加引用完成).然后在代码中使用完全有效名称来使用对象.
完全有效名称能够让编译器决定正在使用哪个对象而避免了命名冲突.但是,名称本身可能
会变得很长或者臃肿.为了解决这个问题,您可以使用Import语句(C#中是using语句)来定义一个别名-一个可以用来替代完全有效名称的略名.例如,下面的代码片段为两个对象定义了别名,并在定义这两个对象时使用了别名.

  • Visual Basic

Imports MyChart = C1.Win.C1Chart Dim chart As MyChart

  • C#

using C1.Win.C1Chart = MyChart; MyChart chart;
如果没有使用 Import 语句定义别名,那么使用不需要限制来指定在工程中唯一的名称.
作为一个警告,除非显式在代码中指定,它用来确保如下的语句被指定:

  • Visual Basic


Imports C1.Win.C1Chart

  • C#

using C1.Win.C1Chart;
这仅在简单示例代码中适用.指南或者其他更复杂的示例中会指定全名称.

 创建一个.Net2.0 工程

为了创建一个.Net 工程,完成以下步骤:

  1. 在Microsoft Visual Studio .NET中的File菜单中,选择New Project.来打开New Project对话框.
  2. 在Project Types项目中,选择Visual Basic或者Visual C#.请注意其中的一个会位于 Other Languages项目下.
  3. 在右边的Templates选择中选择Windows Application

  1. 通过输入或者浏览来在Location项目中为您的应用程序选择一个目录.然后点击OK按

钮.

  1. 一个新的Microsoft Visual Studio .NET工程会在制定的目录地址中被创建出来.额外地, 一个新的Form1会出现在设计器视图中.
  2. 在ToolBar中双击C1Chart控件来将其添加到Form1上.关于如何将一个控件添加到 ToolBar上的更多信息,请参考在工程中添加一个C1Chart组件(13页)

 创建一个移动设备应用程序

为了创建一个.Net2.0 移动设备应用程序工程,完成以下步骤:

  1. 在Microsoft Visual Studio .NET 2005中的File菜单中,选择New Project.来打开New Project对话框.
  2. 在Project Types项目中,选择Visual Basic或者Visual C#.请注意其中的一个会位于 Other Languages项目下.
  3. 展开Smart Device节点,并从列出的设备类型中选择一个.
  4. 在右边的Templates选择中选择Device Application.

  1. 在Name文本框中输入名字,然后点击OK按钮.一个新的工程会被创建出来.额外地,一个新的Form1会出现在设计器视图中.
  2. 在您的工程中添加C1Chart程序集的引用,关于此的更多信息,请参见在一个工程中添加C1Chart控件

在您安装.Net2.0 的 ComponentOne Studio 时,在安装过程中 Create a ComponentOne Visual Studio 2005 Toolbox Tab 复选框默认情况下是选中的.当您打开 Visual Studio 2005 时, 一个含有 ComponentOne 控件的 ComponentOne Studio for .NET 2.0 选项卡会自动添加到
ToolBox 中.如果您在安装过程中不选中 Create a ComponentOne Visual Studio 2005
Toolbox Tab 复选框,那么您可以在安装之后,手动地添加 ComponentOne 控件到 ToolBox 中.
ComponentOne Chart for .NET 2.0 提供了以下的控件:

    • C1Chart
    • C1Chart3D

如果您需要使用 C1Chart,添加这些控件到您的工程中,或者在您的工程中引用
C1.Win.C1Chart 命名空间.

 手动添加 C1Chart 到您的工程中

当您安装过 C1Chart 后,以下的 C1Chart 控件会自动地出现在 Visual Studio Toolbox 自定义对话框中:

  • C1Chart
  • C1Chart3D 为了手动添加 C1Chart 控件到 Visual Studio Toolbox 中去,需要完成以下的步骤:
  1. 打开Visual Studio IDE (Microsoft开发环境).确认ToolBox是可见的(如果需要在View菜单中选择Toolbox).然后右键点击,来展开它的上下文菜单.
  2. 为了让C1Chart控件在ToolBox中出现在自己应在的选项卡内,在上下文菜单中选择

Add Tab,并输入名字,例如C1Chart.

  1. 在选项卡上右键点击,然后在出现的上下文菜单中选择Choose Items.
  2. Choose Toolbox Items对话框将会出现.
  3. 在对话框中,选择.NET Framework Components选项卡.按照Namespace将项目进行排序(通过在表格的表头上点击Namespace).然后将所有属于C1.Win.C1Chart命名空间的控件前面的复选框都选中.请注意一个命名空间内可能含有多个控件.


在窗体上添加 C1Chart 控件完成以下步骤来在窗体上添加 C1Chart 控件:

  1. 添加C1Chart控件到Visual Studio Toolbox中去.
  2. 双击控件,或者将其拖拽到窗体上.

添加对程序集的引用为了添加对程序集的引用,需要完成以下步骤:

  1. 在您的工程的Project菜单中选择Add Reference.
  2. 在.Net选项卡中选择ComponentOne C1Chart程序集.或者通过浏览来找到

C1.Win.C1Chart.2.dll文件并点击OK按钮.

  1. 双击窗体标题区域来打开代码.在代码文件的开头部分,加入以下Imports语句(C#中是 using):


Imports C1.Win.C1Chart

注意:这将会使得在 C1Chart 程序集中定义的对象在工程中都是可见的.更多信息请参见命名空间(11 页).

 迁移一个 C1Chart 工程到到 Visual Studio 2005

为了迁移一个使用了 ComponentOne 控件的工程到 Visual Studio 2005 中,有两个步骤是必
须进行的.首先,您必须将您的工程转换为 Visual Studio 2005 工程.这将会包括将原有引用删除, 并指向一些新的引用的过程.第二, .licx 文件必须被更新,才能够让您的工程能够正常运行.
进行工程转换:

  1. 打开Visual Studio 2005 ,然后选择File, Open Project.
  2. 定位您想要转换到Visual Studio 2005的工程的.sln文件.选择它并点击Open.Visual

Studio Conversion Wizard对话框将会出现.

  1. 点击Next.
  2. 选择Yes, create a backup before converting来给您现有的工程创建一个备份.然后点击Next.

  1. 点击Finish按钮来完成到Visual Studio 2005的转换. Conversion Complete窗口将会出现.
  2. 如果您想查看转换的Log,那么点击Show the conversion log when the wizard is closed复选框.

  1. 点击Close按钮,工程将会出现.现在您必须将工程中原先引用的所有

ComponentOne的.dll文件删除,并重新指向新的.

  1. 到Solution Explorer (View, Solution Explorer)中.选择工程,并点击Show All Files 按钮.

注意: Show All Files 按钮在解决方案工程节点没有选中时不会出现在 Solution
Explorer toolbar 中.

  1. 展开References节点,右键点击C1.Common并选择Remove.然后以同样的操作步骤删除C1.Win.C1Chart引用.
  2. 右键点击References节点并选择Add Reference.
  3. 定位并选择C1.Win.C1Chart.2.dll文件.然后点击OK按钮来添加到工程.

为了更新.lics 文件

  1. 在Solution Explorer中,右键点击licenses.licx文件,并选择Delete.

  1. 点击OK来永久性地删除licenses.licx文件.然后工程必须被重新编译来生成一个新的,更新过的版本的.licx文件.
  2. 点击Start Debugging按钮来编译并运行工程.新的.licx文件可能在Solution Explorer中是不可见的.
  3. 选择File, Close来关闭窗体,然后在Solution Explorer中的Form.vb或者Form.cs文件上双击,新的licenses.licx文件将会出现在文件列表中.

迁移动作已经完成.

  • No labels