冰藍(lán)科技是全球著名的文檔管理控件開(kāi)發(fā)商，其旗下的Spire系列產(chǎn)品支持.NET、Silverlight和WPF平臺(tái)，對(duì)中文有著超強(qiáng)的支持，并且對(duì)比同類型產(chǎn)品有著更低價(jià)格的優(yōu)勢(shì)。冰藍(lán)科技為每個(gè)產(chǎn)品都提供了試用版本，相關(guān)產(chǎn)品都可以通過(guò)在對(duì)應(yīng)的產(chǎn)品目錄下進(jìn)行免費(fèi)下載試用，試用版對(duì)產(chǎn)品功能不做任何限制，不過(guò)試用版本將在結(jié)果文檔中添加一個(gè)額外的包含評(píng)估信息的工作表（Spire.XLS）或者一行警告信息。當(dāng)你購(gòu)買(mǎi)一項(xiàng)許可證后，你將通過(guò)郵件獲得一個(gè).xml格式的許可證文件。應(yīng)用這一文件后，警告信息就會(huì)消失。

下面將詳細(xì)介紹什么是許可文件和怎樣應(yīng)用它。包括以下幾點(diǎn)：

• 許可文件介紹
• 如何應(yīng)用許可文件
• 如何把許可文件作為嵌入資源來(lái)應(yīng)用
• 如何在網(wǎng)站應(yīng)用許可文件
• 如何用許可密鑰應(yīng)用許可文件
• 如何同時(shí)應(yīng)用兩個(gè)或兩個(gè)以上許可文件

許可文件介紹

許可文件是一個(gè)XML格式的文件，它包含的信息有：購(gòu)買(mǎi)者的用戶名、郵箱、組織機(jī)構(gòu)，許可證日期，產(chǎn)品名稱，產(chǎn)品版本，以及許可的開(kāi)發(fā)者數(shù)量和許可的網(wǎng)站數(shù)量等。許可文件是數(shù)字簽名的，所以請(qǐng)不要修改它。

你需要在用E-iceblue產(chǎn)品進(jìn)行各種操作之前應(yīng)用許可證，但是在一個(gè)應(yīng)用程序或進(jìn)程中只需要應(yīng)用一次。

如何應(yīng)用許可文件

使用E-iceblue產(chǎn)品進(jìn)行任何操作都將引導(dǎo)許可證模塊檢測(cè)許可證是否已經(jīng)加載，如果沒(méi)有加載，許可證模塊將會(huì)嘗試加載。許可證可以從文件、流或者嵌入的資源顯式或隱式地加載，默認(rèn)是隱式的。

注意：不管隱式調(diào)用方式還是顯示調(diào)用方式，在使用E-iceblue產(chǎn)品之前都必須先應(yīng)用許可文件。

隱式加載

這種模式下，許可證模塊會(huì)嘗試在以下幾個(gè)位置查找許可文件：

• 包含運(yùn)行時(shí)入口程序集（命名為.exe的程序集）的文件夾
• 調(diào)用E-iceblue產(chǎn)品程序集的嵌入資源
• 包含被運(yùn)行時(shí)程序集引用的E-iceblue產(chǎn)品程序集（例如Spire.Doc.dll, Spire.XLS.dll）的文件夾
• 包含在運(yùn)行時(shí)調(diào)用E-iceblue產(chǎn)品的程序集的文件夾

當(dāng)你從E-iceblue這取得許可證時(shí)，默認(rèn)名稱是license.elic.xml.。你可以把它放在上面提及的任何位置。許可證模塊會(huì)從你的應(yīng)用里面自動(dòng)加載它。你也可以修改許可文件的名稱，如果這樣做的話，在你用E-iceblue產(chǎn)品進(jìn)行任何操作之前，必須告知許可證模塊新的文件名稱。比如：

C#:

//告知許可證模塊你-的許可證名稱。
Spire.License.LicenseProvider.SetLicenseFileName("your-license-file-name");

VB.NET:

//告知許可證模塊你-的許可證名稱。
Spire.License.LicenseProvider.SetLicenseFileName("your-license-file-name");

注意：Spire.License.LicenseProvide類 是在Spire.License.dll里面定義的，Spire.License.dll安裝在與Spire.Doc.dll/Spire.Xls.dll相同的路徑下。如果你的代碼里要使用Spire.License.LicenseProvider這個(gè)類，必須引用Spire.License.dll到你的項(xiàng)目里面。

可以通過(guò)許可證模塊來(lái)查找來(lái)獲取許可證名稱，比如：

C#:

//獲取許可證默認(rèn)名稱
String fileName = Spire.License.LicenseProvider.GetLicenseFileName();

VB.NET:

//獲取許可證默認(rèn)名稱
Dim fileName As String = Spire.License.LicenseProvider.GetLicenseFileName()

顯式加載

這個(gè)模式下，許可證模塊試圖將從你提供的特定文件或者流來(lái)加載許可證。

通過(guò)全路徑名顯式的指定許可證文件。

C#:

//指定許可證文件的全路徑名
Spire.License.LicenseProvider.SetLicenseFileFullPath(@"D:\myApp\license.lic");

VB.NET:

//指定許可證文件的全路徑名
Spire.License.LicenseProvider.SetLicenseFileFullPath("D:\myApp\license.lic")

通過(guò)FileInfo對(duì)象顯式指定許可證文件

C#:

//通過(guò)FileInfo對(duì)象指定許可證文件
FileInfo licenseFile = new FileInfo(@"D:\myApp\license.lic");
Spire.License.LicenseProvider.SetLicenseFile(licenseFile);

VB.NET:

//通過(guò)FileInfo對(duì)象指定許可證文件
Dim licenseFile As New FileInfo("D:\myApp\license.lic")
Spire.License.LicenseProvider.SetLicenseFile(licenseFile)

提供許可證數(shù)據(jù)流

C#:

//通過(guò)許可證數(shù)據(jù)流指定許可證
Stream stream = File.OpenRead(@"D:\myApp\license.lic");
Spire.License.LicenseProvider.SetLicenseFileStream(stream);

VB.NET:

//通過(guò)許可證數(shù)據(jù)流指定許可證
Dim stream As Stream = File.OpenRead("D:\myApp\license.lic")
Spire.License.LicenseProvider.SetLicenseFileStream(stream)

參照：怎樣通過(guò)許可證密鑰應(yīng)用許可證

如何把許可文件作為嵌入資源來(lái)應(yīng)用

把許可證文件以嵌入的資源方式包含到調(diào)用E-iceblue產(chǎn)品程序集中是很好的方式，它會(huì)讓你的發(fā)布和部署更簡(jiǎn)單。你再也不用擔(dān)心許可證會(huì)丟失。在Visual Studio中通過(guò)以下幾個(gè)步驟來(lái)包含許可文件作為嵌入的資源：

• 在解決方案管理器中，右鍵點(diǎn)擊你的工程，然后點(diǎn)擊添加|添加現(xiàn)有項(xiàng)目菜單。
• 在打開(kāi)文件瀏覽對(duì)話框中找到你的許可證文件，然后點(diǎn)擊添加按鈕把它添加到你的工程。
• 在解決方案管理器中選中許可證文件，并在屬性窗口設(shè)置創(chuàng)建方式為嵌入資源。
• 如果你的許可證文件不是默認(rèn)名稱license.elic.xml，在你的代碼里面調(diào)用Spire.License.LicenseProvider.SetLicenseFileName方法將真實(shí)的名稱告知許可證模塊。

另請(qǐng)參照：怎樣通過(guò)許可證密鑰應(yīng)用許可證

如何在網(wǎng)站應(yīng)用許可文件

如果你想在網(wǎng)站上應(yīng)用許可證文件，你只需要把許可證文件復(fù)制到包含網(wǎng)站引用程序集的Bin文件夾里。

另請(qǐng)參照：怎樣通過(guò)許可證密鑰應(yīng)用許可證

如何用許可密鑰應(yīng)用許可文件

有時(shí)，你的應(yīng)用程序因?yàn)槿鄙贆?quán)限或其他原因無(wú)法讀取許可文件，在這種情況下，你可以調(diào)用Spire.License.LicenseProvider.SetLicenseKey(String key)方法來(lái)應(yīng)用許可證。Key參數(shù)是xml許可文件的元素Key屬性的值。為了確保在使用我們產(chǎn)品進(jìn)行任何操作之前能成功應(yīng)用許可證，我們建議在入口方法的第一行調(diào)用這個(gè)方法。

C#:

//注冊(cè)許可證密鑰
Spire.License.LicenseProvider.SetLicenseKey("your license key");

VB.NET:

//注冊(cè)許可證密鑰
Spire.License.LicenseProvider.SetLicenseKey("your license key")

• 如果是WinForm應(yīng)用程序或者是Console應(yīng)用程序，上面的代碼應(yīng)該添加到main方法里面。
• 如果是Web應(yīng)用程序，需要先添加Global.asax到你的項(xiàng)目然后添加以上方法代碼到Application_Start方法里。
• 如果是Sliverlight應(yīng)用程序，添加以上方法代碼到App.Application_Startup方法。我們假設(shè)App類是SliverlightAppEntry。

如何同時(shí)應(yīng)用兩個(gè)或兩個(gè)以上許可文件

有時(shí)，你需要在應(yīng)用程序中應(yīng)用2個(gè)或者多個(gè)許可證，在這種情況下，有兩種方法可以實(shí)現(xiàn)。

如果你要通過(guò)許可證密鑰的方式應(yīng)用兩個(gè)或兩個(gè)以上的許可證，你可以在你整個(gè)方法的起始位置調(diào)用以下方法。

Spire.License.LicenseProvider.SetLicenseKey("license key of license1");
Spire.License.LicenseProvider.LoadLicense();  
Spire.License.LicenseProvider.SetLicenseKey("license key of license2");  
Spire.License.LicenseProvider.LoadLicense();

如果你是通過(guò)許可證文件來(lái)應(yīng)用許可證，你可以調(diào)用下面的方法：

Spire.License.LicenseProvider.SetLicenseFileName("license1.elic.xml");  
Spire.License.LicenseProvider.LoadLicense();  
Spire.License.LicenseProvider.SetLicenseFileName("license2.elic.xml");  
Spire.License.LicenseProvider.LoadLicense();

注意：Spire.License.LicenseProvide 是定義在Spire.License.dll里面的。Spire.License.dll的安裝路徑與Spire.Doc.dll和Spire.Xls.dll相同。如果你的代碼里要使用Spire.License.LicenseProvider這個(gè)類，你必須引用Spire.License.dll到你的項(xiàng)目里面。

如果您還有任何疑問(wèn)，歡迎咨詢或者發(fā)送郵件到sales@fc6vip.cn