XBRL是一種用于業務報告的全球通用的基于XML的標準和文件格式。它使各種公司和會計組織更容易有效，準確地組織，編制和傳達財務報表或其他與財務相關的信息/數據。由于XBRL基于XML（可擴展標記語言），因此它使用標簽來保留和解析每段財務數據。

Aspose.Finance for .NET是Aspose廠商新推出的格式處理產品，用于處理與財務相關的格式的API，可以輕松創建，閱讀和驗證可擴展業務報告語言XBRL和iXBRL格式。

本文提供有關使用XBRL標準的業務報告，XBRL的目的以及如何在 .NET應用程序中自動創建基于XBRL的業務報告的過程的信息。在本文中將學習這些功能：

• 從頭開始創建XBRL實例
• 解析XBRL或iXBRL文件
• 驗證XBRL或iXBRL文件

Aspose.Finance for .NET已在慧都網上線，如果你還沒有用過Aspose.Finance可以點擊這里下載最新版測試。

在C＃中從頭開始創建XBRL實例

.NET的Aspose.Finance使從頭開始創建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");

在C＃中解析XBRL或iXBRL文件

.NET的Aspose.Finance提供了一種簡單的方法來解析XBRL文件并在幾行代碼中檢索其內容。以下各節包含有關如何解析XBRL和iXBRL文件的步驟和代碼示例。

在C＃中解析XBRL或iXBRL文件

以下是使用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];
Listfacts = xbrlInstance.Facts;
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
Listcontexts = xbrlInstance.Contexts;
Listunits = xbrlInstance.Units;

在C＃中解析iXBRL文件

解析iXBRL文件相對比較容易，可以使用以下步驟完成。

• 創建InlineXbrlDocument類的對象，并使用iXBRL文件的路徑對其進行初始化。
• 使用InlineXbrlDocument對象（即InlineXbrlDocument.Facts等）訪問文件的內容。

以下代碼示例顯示了如何在C＃中解析和讀取iXBRL文件。

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
ListinlineFacts = document.Facts;
Listcontexts = document.Contexts;
Listunits = 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)
{
    ListvalidationErrors = xbrlInstance.ValidationErrors;
}

在C＃中驗證iXBRL文件

以下步驟用于驗證Inline XBRL文件。

• 創建InlineXbrlDocument類的實例，并使用iXBRL文件的路徑對其進行初始化。
• 調用InlineXbrlDocument.Validate（）方法。

以下代碼示例顯示了如何在C＃中驗證iXBRL文件。

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
    ListvalidationErrors = document.ValidationErrors;
}