冰藍科技是全球著名的文檔管理控件開發商，其旗下的Spire系列產品支持.NET、Silverlight和WPF平臺，對中文有著超強的支持，并且對比同類型產品有著更低價格的優勢。冰藍科技為每個產品都提供了試用版本，相關產品都可以通過在對應的產品目錄下進行免費下載試用，試用版對產品功能不做任何限制，不過試用版本將在結果文檔中添加一個額外的包含評估信息的工作表（Spire.XLS）或者一行警告信息。當你購買一項許可證后，你將通過郵件獲得一個.xml格式的許可證文件。應用這一文件后，警告信息就會消失。

下面將詳細介紹什么是許可文件和怎樣應用它。包括以下幾點：

• 許可文件介紹
• 如何應用許可文件
• 如何把許可文件作為嵌入資源來應用
• 如何在網站應用許可文件
• 如何用許可密鑰應用許可文件
• 如何同時應用兩個或兩個以上許可文件

許可文件介紹

許可文件是一個XML格式的文件，它包含的信息有：購買者的用戶名、郵箱、組織機構，許可證日期，產品名稱，產品版本，以及許可的開發者數量和許可的網站數量等。許可文件是數字簽名的，所以請不要修改它。

你需要在用E-iceblue產品進行各種操作之前應用許可證，但是在一個應用程序或進程中只需要應用一次。

如何應用許可文件

使用E-iceblue產品進行任何操作都將引導許可證模塊檢測許可證是否已經加載，如果沒有加載，許可證模塊將會嘗試加載。許可證可以從文件、流或者嵌入的資源顯式或隱式地加載，默認是隱式的。

注意：不管隱式調用方式還是顯示調用方式，在使用E-iceblue產品之前都必須先應用許可文件。

隱式加載

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

• 包含運行時入口程序集（命名為.exe的程序集）的文件夾
• 調用E-iceblue產品程序集的嵌入資源
• 包含被運行時程序集引用的E-iceblue產品程序集（例如Spire.Doc.dll, Spire.XLS.dll）的文件夾
• 包含在運行時調用E-iceblue產品的程序集的文件夾

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

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這個類，必須引用Spire.License.dll到你的項目里面。

可以通過許可證模塊來查找來獲取許可證名稱，比如：

C#:

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

VB.NET:

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

顯式加載

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

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

C#:

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

VB.NET:

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

通過FileInfo對象顯式指定許可證文件

C#:

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

VB.NET:

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

提供許可證數據流

C#:

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

VB.NET:

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

參照：怎樣通過許可證密鑰應用許可證

如何把許可文件作為嵌入資源來應用

把許可證文件以嵌入的資源方式包含到調用E-iceblue產品程序集中是很好的方式，它會讓你的發布和部署更簡單。你再也不用擔心許可證會丟失。在Visual Studio中通過以下幾個步驟來包含許可文件作為嵌入的資源：

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

另請參照：怎樣通過許可證密鑰應用許可證

如何在網站應用許可文件

如果你想在網站上應用許可證文件，你只需要把許可證文件復制到包含網站引用程序集的Bin文件夾里。

另請參照：怎樣通過許可證密鑰應用許可證

如何用許可密鑰應用許可文件

有時，你的應用程序因為缺少權限或其他原因無法讀取許可文件，在這種情況下，你可以調用Spire.License.LicenseProvider.SetLicenseKey(String key)方法來應用許可證。Key參數是xml許可文件的元素Key屬性的值。為了確保在使用我們產品進行任何操作之前能成功應用許可證，我們建議在入口方法的第一行調用這個方法。

C#:

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

VB.NET:

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

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

如何同時應用兩個或兩個以上許可文件

有時，你需要在應用程序中應用2個或者多個許可證，在這種情況下，有兩種方法可以實現。

如果你要通過許可證密鑰的方式應用兩個或兩個以上的許可證，你可以在你整個方法的起始位置調用以下方法。

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

如果你是通過許可證文件來應用許可證，你可以調用下面的方法：

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這個類，你必須引用Spire.License.dll到你的項目里面。

如果您還有任何疑問，歡迎咨詢或者發送郵件到sales@ke049m.cn