文件轉換是 Azure Translator 的雲端 REST API 功能。 文件翻譯 API 允許非同步且快速且準確地完成完整文件的原始碼與目標翻譯，支援多種語言及多種檔案格式。 文件翻譯軟體開發套件（SDK）是一組函式庫與工具，讓您能輕鬆將文件翻譯 REST API 功能整合到您的應用程式中。
支援的語言
文件翻譯 SDK 支援以下程式語言：
| 語言→ SDK 版本 | Package | 用戶端程式庫 | 支援的 API 版本 |
|---|---|---|---|
🆕 .NET/C# → 2.0.0 |
NuGet | 適用於 .NET 的 Azure SDK | |
🆕 Python → 1.0.0 |
PyPi | 適用於 Python 的 Azure SDK |
變更記錄和版本歷程記錄
本節針對文件翻譯的特性和功能發行、變更、更新和增強，提供了以版本為基礎的描述。
版本 2.0.0
變更記錄/版本歷程記錄
讀我檔案
範例
在你的應用程式中使用文件翻譯 SDK
文件翻譯 SDK 允許在您的應用程式中使用與管理翻譯服務。 SDK 建立在底層的文件轉譯 REST API 之上，供你在程式語言範式中使用。 請選擇您慣用的程式設計語言：
1. 安裝 SDK 用戶端程式庫
dotnet add package Azure.AI.Translation.Document --version 2.0.0
Install-Package Azure.AI.Translation.Document -Version 2.0.0
2. 將 SDK 用戶端程式庫匯入您的應用程式中
3.驗證用戶端
建立一個物件實例 DocumentTranslationClient 來與文件轉譯 SDK 互動，然後呼叫該用戶端物件的方法來與服務互動。 使用 DocumentTranslationClient 是運用文件翻譯客戶端函式庫的主要介面。 它提供同步和非同步方法來執行作業。
非同步批次轉譯
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));
同步單一文件翻譯
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
4. 建置應用程式
非同步批次轉譯
文件翻譯批次介面需要以下輸入：
- 將檔案上傳至 Azure Blob 儲存體來源容器 (sourceUri)。
- 提供可將已翻譯文件寫入的目標容器(targetUri)。
- 包含目標語言代碼 (targetLanguage)。
Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";
DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)
同步單一文件翻譯
說明選項
Microsoft Q&A開發者社群與 Stack Overflow 論壇提供關於 Azure Text 翻譯及其他服務的問題，供他們提問與解答。 Microsoft 會監視論壇，並回覆社群尚未回答的問題。
秘訣
若要確保我們看到您的 Microsoft Q&A 問題，請使用 microsoft-translator 加以標記。
若要確保我們看到您的 Stack Overflow 問題，請使用 Azure Translator 加以標記。