本文提供有關使用 XBRL 標準的業務報告、XBRL 的用途以及如何在 .NET 應用程序中自動創建基於 XBRL 的業務報告的過程的信息。此外，它包含分步方法來解析 XBRL 和 iXBRL 文件並使用 C# 以編程方式檢索數據。最後但同樣重要的是，它提供了一些使用 C# 驗證 XBRL 和 iXBRL 文件的簡單方法。
可擴展商業報告語言 (XBRL)
XBRL 是全球使用的基於 XML 的商業報告標準和文件格式。它使各種公司和會計組織更容易高效、準確地組織、編制和傳達財務報表或其他與財務相關的信息/數據。由於 XBRL 基於 XML（可擴展標記語言），它使用標籤來保存和解析每一個財務數據。 iXBRL（內聯 XBRL）是另一種變體，可以同時以人類可讀和機器可讀的形式保存財務數據。與 XBRL 不同，iXBRL 使用 HTML 標準以及一些用於圖形和報表的額外標籤。
XBRL 和 iXBRL 中的標籤都使用與 XBRL 兼容的軟件進行解析以檢索數據。為了自動化 XBRL 解析，Aspose 提供了 Aspose.Finance for .NET API。它是一個 .NET 類庫，可以更輕鬆地使用 C# 或 VB.NET 以編程方式創建 XBRL 實例。此外，它還允許您在 .NET 應用程序中解析和驗證 XBRL 或 iXBRL 文件。 Aspose.Finance for .NET 提供了以下您將在本文中學習的 XBRL/iXBRL 操作功能。
您可以從 NuGet 或 下載 它的 DLL 安裝 Aspose.Finance for .NET 以在您的項目中手動引用它。
在 C# 中從頭開始創建 XBRL 實例
Aspose.Finance for .NET 使從頭開始創建 XBRL 實例變得簡單。您還可以在新創建的 XBRL 實例中添加模式引用、上下文、單位、項目、腳註鏈接、角色引用和弧形角色引用。以下是創建 XBRL 實例的步驟：
- 創建 XbrlDocument 類的實例。
- 將實例的集合從 XbrlDocument 對象訪問到 XbrlInstanceCollection 對象。
- 使用 XbrlInstanceCollection.Add() 方法添加新的 XBRL 實例。
- 使用 XbrlDocument.Save(string) 方法保存 XBRL 文件。
以下代碼示例顯示瞭如何在 C# 中創建 XBRL 實例。
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
創建 XBRL 實例後，您可以向其中插入對象，這些將在以下文章中討論：
在 C# 中解析 XBRL 或 iXBRL 文件
Aspose.Finance for .NET 提供了一種簡單的方法來解析 XBRL 文件並在幾行代碼內檢索其內容。以下部分包含如何解析 XBRL 和 iXBRL 文件的步驟和代碼示例。
在 C# 中解析 XBRL 文件
以下是使用 Aspose.Finance for .NET 解析 XBRL 文件的步驟。
- 創建 XbrlDocument 類的實例並使用 XBRL 文件的路徑對其進行初始化。
- 使用 XbrlDocument.XbrlInstances 屬性將 XBRL 中的實例放入 XbrlInstanceCollection 對像中。
- 使用 XbrlInstance 類從集合中訪問所需的 XBRL 實例。
- 解析 XBRL 實例的內容。
以下代碼示例演示瞭如何在 C# 中解析 XBRL 文件。
XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
List<Fact> facts = xbrlInstance.Facts;
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
List<Context> contexts = xbrlInstance.Contexts;
List<Unit> units = xbrlInstance.Units;
在 C# 中解析 iXBRL 文件
解析 iXBRL 文件相對容易，可以使用以下步驟完成。
- 創建 InlineXbrlDocument 類的對象並使用 iXBRL 文件的路徑對其進行初始化。
- 使用 InlineXbrlDocument 對象訪問文件的內容，即 InlineXbrlDocument.Facts 等。
以下代碼示例顯示瞭如何在 C# 中解析和讀取 iXBRL 文件。
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
在 C# 中驗證 XBRL 或 iXBRL 文件
XBRL 和 iXBRL 文件必須分別符合 XBRL 規範 和 iXBRL 規範 中的驗證規則。違反規範規則可能會使文件無效。 Aspose.Finance for .NET 還允許您驗證 XBRL 或 iXBRL 文件以找出錯誤。以下部分演示瞭如何驗證 XBRL 和 iXBRL 文件。
在 C# 中驗證 XBRL 文件
以下是驗證 XBRL 文件的步驟：
- 創建 XbrlDocument 類的實例。
- 從 XbrlInstanceCollection 訪問要驗證的實例。
- 使用 XbrlInstance.Validate() 方法驗證 XBRL 實例。
以下代碼示例顯示如何在 C# 中驗證 XBRL 文件。
XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
xbrlInstance.Validate();
if(xbrlInstance.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = xbrlInstance.ValidationErrors;
}
在 C# 中驗證 iXBRL 文件
以下步驟用於驗證內聯 XBRL 文件。
- 創建 InlineXbrlDocument 類的實例並使用 iXBRL 文件的路徑對其進行初始化。
- 調用 InlineXbrlDocument.Validate() 方法。
以下代碼示例顯示瞭如何在 C# 中驗證 iXBRL 文件。
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
從 此處 了解有關驗證錯誤代碼和錯誤消息的更多信息。
探索 API
您可以從以下資源中了解有關如何創建、解析和驗證 XBRL 和 iXBRL 文件的更多信息：
免費試用 Aspose.Finance for .NET
Aspose 提供臨時許可證以免費評估其 API。您也可以發布您的請求並獲得臨時許可證。