Aspose.words for.NET 授權須知

支持的平臺

Aspose.Words 可作為 .NET、Java、C++ 和 Python 的四種不同產品使用，

系統要求

Aspose.Words for .NET支持任何安裝了.NET framework、Mono或.NET Core的64位或32位操作系統

支持的文檔格式

下表顯示了 Aspose.Words for .NET 支持的輸入和輸出文件格式：

格式	描述	Load	save
DOC	Microsoft Word 97 – 2007 文檔。
DOT	Microsoft Word 97 – 2007 模板。
DocPreWord60	文檔為 Word 6 或 Word 95 格式。
DOCX	Office Open XML WordprocessingML 文檔（無宏）。
DOCM	Office Open XML WordprocessingML 啟用宏的文檔。
DOTX	Office Open XML WordprocessingML 模板（無宏）。
DOTM	Office Open XML WordprocessingML 啟用宏的模板。
FlatOpc	Office Open XML WordprocessingML 存儲在平面 XML 文件而不是 ZIP 包中。
FlatOpcMacroEnabled	Office Open XML WordprocessingML 啟用宏的文檔存儲在平面 XML 文件中，而不是 ZIP 包中。
FlatOpcTemplate	Office Open XML WordprocessingML 模板（無宏）存儲在平面 XML 文件而不是 ZIP 包中。
FlatOpcTemplateMacroEnabled	Office Open XML WordprocessingML 啟用宏的模板存儲在平面 XML 文件中，而不是 ZIP 包中。
XML	XML 文檔。
RTF	RTF 格式。
WordML	Microsoft Word 2003 WordprocessingML 格式。
HTML	HTML 或 XHTML 格式。
MHTML	MHTML（Web 存檔）格式。
MOBI	MOBI 是 MobiPocket 閱讀器和亞馬遜 Kindle 閱讀器使用的電子書格式。
AZW3	AZW3 是亞馬遜 Kindle 閱讀器使用的一種電子書格式。
CHM	CHM（編譯的 HTML 幫助）格式。
ODT	ODF 文本文檔。
OTT	ODF 文本文檔模板。
TXT	純文本。
MD	Markdown文件。
PDF	將文檔另存為 PDF (Adobe Portable Document) 格式。
XPS	以 XPS（XML 紙張規范）格式保存文檔。
XamlFixed	將可擴展應用程序標記語言 (XAML) 格式的文檔另存為固定文檔。
SVG	以 SVG（可縮放矢量圖形）格式保存文檔。
HtmlFixed	使用絕對定位的元素以 HTML 格式保存文檔。
OpenXps	以 OpenXPS (Ecma-388) 格式保存文檔。
ps	以 PS (PostScript) 格式保存文檔。
PCL	以 PCL（打印機控制語言）格式保存文檔。
EPUB	以 IDPF EPUB 格式保存文檔。
XamlFlow	將可擴展應用程序標記語言 (XAML) 格式的文檔另存為流文檔。
XamlFlowPack	將可擴展應用程序標記語言 (XAML) 包格式的文檔另存為流文檔。
TIFF	呈現文檔的一頁或多頁并將它們保存到單個或多頁 TIFF 文件中。
PNG	呈現文檔的頁面并將其另存為 PNG 文件。
BMP	呈現文檔的一頁并將其另存為 BMP 文件。
EMF	呈現文檔的一頁并將其保存為矢量 EMF（增強型元文件）文件。
JPEG	呈現文檔頁面并將其另存為 JPEG 文件。
GIF	呈現文檔頁面并將其保存為 GIF 文件。

許可和訂閱

免費試用或臨時許可證

評估版與購買版相同——試用版只需添加幾行代碼即可獲得許可。

但評估版在加載和保存時會在文檔頂部插入一個評估水印，并將最大文檔大小限制為幾百個段落。

臨時執照

如果您希望在不受試用版限制的情況下測試 Aspose.Words，您還可以申請一個 30 天的臨時許可證。

購買的許可證

購買后，您需要申請許可文件或將許可文件作為嵌入資源包含在內。本節描述如何完成此操作的選項，以及對一些常見問題的評論。

您需要設置許可證：每個應用程序域僅一次/在使用任何其他 Aspose.Words 類之前

許可證申請選項

可以從不同位置應用許可證：

• 顯式路徑
• 包含Aspose.Words.dll文件的文件夾
• 包含調用Aspose.Words.dll的程序集的文件夾
• 包含入口程序集的文件夾（您的.exe）
• 程序集中的嵌入式資源稱為Aspose.Words.dll
• 作為計量許可證——一種新的許可機制

當您在應用程序中引用Aspose.Words.dll時，該庫將復制到您的輸出目錄（除非該條目的屬性中的Copy Local設置為 false）。設置許可證最簡單的方法通常是將許可證文件放在與Aspose.Words.dll相同的文件夾中，并僅指定文件名而不指定路徑。

使用文件或流對象申請許可證

在開發應用程序時，在使用 Aspose.Words 類之前在啟動代碼中調用SetLicense 。

從文件加載許可證

使用方法，您可以嘗試在嵌入的資源或程序集文件夾中找到許可文件以供進一步使用。

以下代碼示例顯示如何從文件夾初始化許可證：

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
Aspose.Words.License license = new Aspose.Words.License();

// This line attempts to set a license from several locations relative to the executable and Aspose.Words.dll.
// You can also use the additional overload to load a license from a stream, this is useful for instance when the
// license is stored as an embedded resource
try
{
license.SetLicense("Aspose.Words.lic");
Console.WriteLine("License set successfully.");
}
catch (Exception e)
{
// We do not ship any license with this example, visit the Aspose site to obtain either a temporary or permanent license.
Console.WriteLine("\nThere was an error setting the license: " + e.Message);
}

從流對象加載許可證

以下代碼示例顯示如何使用另一個方法從流中初始化許可證：

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
Aspose.Words.License license = new Aspose.Words.License();

try
{
// Initializes a license from a stream
MemoryStream stream = new MemoryStream(File.ReadAllBytes(@"Aspose.Words.lic"));
license.SetLicense(stream);
Console.WriteLine("License set successfully.");
}
catch (Exception e)
{
// We do not ship any license with this example, visit the Aspose site to obtain either a temporary or permanent license.
Console.WriteLine("\nThere was an error setting the license: " + e.Message);
}

將許可證文件作為嵌入式資源包括在內

將許可證與您的應用程序打包并確保它不會丟失的一種巧妙方法是將其作為嵌入式資源包含到調用 Aspose.Words 的程序集中。要將文件包含為嵌入式資源，請執行以下步驟：

1. 在 Visual Studio 中，使用“文件 | ”將 .lic 文件包含到項目中。添加現有項目... ”菜單。
2. 在 Solution Explorer 中選擇文件，并在 Properties 窗口中設置“ Build Action to Embedded Resource” 。
3. 在您的代碼中，調用僅傳遞資源文件短名稱的SetLicense 。

應用計量許可

Aspose.Words 允許開發人員應用計量密鑰。這是一種新的許可機制。

新的許可機制將與現有的許可方法一起使用。那些希望根據 API 功能的使用情況進行計費的客戶可以使用計量許可。

完成獲得此類許可證的所有必要步驟后，您將收到密鑰，而不是許可證文件。可以使用為此目的專門引入的

以下代碼示例顯示如何設置計量公鑰和私鑰：

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// set metered public and private keys
Aspose.Words.Metered metered = new Aspose.Words.Metered();
// Access the setMeteredKey property and pass public and private keys as parameters
metered.SetMeteredKey("*****", "*****");

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_QuickStart();

// Load the document from disk.
Document doc = new Document(dataDir + "Template.doc");
//Get the page count of document
Console.WriteLine(doc.PageCount);

通常在應用程序啟動時應用一次計量許可證就足夠了。但是，如果計量許可機制在24小時內無法與Aspose服務器通信，Aspose.Words將退出許可模式并切換到評估模式，為避免這種情況，您應該定期檢查許可狀態，如果Aspose.Words變成評估模式，請重新申請計量許可證。

更改許可證文件名

許可證文件名不必是“Aspose.Words.LIC”。您可以根據自己的喜好重命名它，并在您的應用程序中設置許可證時使用該名稱。

“找不到許可證文件名”異常

當您購買并下載許可證時，Aspose 網站將許可證文件命名為“Aspose.Words.LIC”。您使用瀏覽器下載許可證文件。在這種情況下，一些瀏覽器將許可文件識別為 XML 并向其附加 .xml 擴展名，因此您計算機上的完整文件名變為“Aspose.Words.lic.XML”。

當 Microsoft Windows 配置為隱藏已知文件類型的擴展名時（不幸的是，這是大多數 Windows 安裝中的默認設置），許可證文件將顯示為“Aspose.Words. LIC”在 Windows 資源管理器中。你可能會認為這是真實的文件名并調用SetLicense傳遞給它“Aspose.Words.LIC”，但是沒有這樣的文件，因此是異常。

要解決此問題，請重命名文件以刪除不可見的 .xml 擴展名。我們還建議您禁用 Microsoft Windows 中的“隱藏擴展”選項。

使用多個 Aspose 產品

如果您在應用程序中使用多個 Aspose 產品，例如 Aspose.Words 和 Aspose.Cells，這里有一些有用的提示：

• 分別為每個 Aspose 產品設置 License。即使所有組件都有一個許可證文件，例如“Aspose.Total.lic”，您仍然需要為應用程序中使用的每個 Aspose 產品單獨調用SetLicense 。
• 使用完全合格的許可證類別名稱。每個 Aspose 產品在其自己的命名空間中都有一個License類。例如，Aspose.Words 有Aspose.Words.License，Aspose.Cells 有 Aspose.Cells.License 類。使用完全限定的類名可以避免混淆哪個許可證適用于哪個產品。

歡迎下載|體驗更多Aspose產品