Добавить пользовательские XML-части с идентификатором в рабочую книгу

Введение

Когда дело доходит до программного управления и манипулирования файлами Excel, Aspose.Cells for .NET выделяется как мощный инструмент. Одной из его интригующих функций является возможность интегрировать пользовательские части XML в вашу книгу Excel. Это может показаться немного техничным, но не волнуйтесь! К концу этого руководства вы будете иметь четкое представление о том, как добавлять пользовательские части XML с идентификаторами в вашу книгу и извлекать их при необходимости.

Предпосылки

Прежде чем погрузиться в код, необходимо настроить несколько вещей:

  1. Visual Studio: убедитесь, что на вашем компьютере установлена Visual Studio, так как мы будем использовать ее для кодирования.
  2. Aspose.Cells for .NET: Вам необходимо установить Aspose.Cells for .NET. Если вы еще этого не сделали, вы можетескачать здесь.
  3. .NET Framework: Знакомство с .NET Framework и языком программирования C# будет полезным. Как только вы выполните все необходимые условия, настанет время применить магию кодирования!

Импортные пакеты

Чтобы использовать Aspose.Cells, вам нужно добавить требуемое пространство имен в начало вашего кода. Вот как это сделать:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Эта строка позволяет получить доступ ко всем функциям, предоставляемым Aspose.Cells. Теперь, когда мы подготовили почву, давайте разобьем процесс на управляемые шаги. Таким образом, вы сможете следовать за ним, не чувствуя себя подавленным.

Шаг 1: Создайте пустую рабочую книгу

Для начала вам нужно создать экземплярWorkbook класс, представляющий вашу книгу Excel.

// Создать пустую книгу.
Workbook wb = new Workbook();

Эта простая строка инициализирует новую рабочую книгу, в которую мы можем добавлять наши пользовательские XML-части.

Шаг 2: Подготовьте данные и схему XML

Далее вам нужно подготовить некоторые данные в виде массива байтов. Хотя в нашем примере используются данные-заполнители, в реальном сценарии вы заменили бы эти массивы байтов фактическими данными XML и схемой, которые вы хотите интегрировать в свою рабочую книгу.

// Некоторые данные в виде массива байтов.
// Вместо этого используйте правильный XML и схему.
byte[] btsData = new byte[] { 1, 2, 3 };
byte[] btsSchema = new byte[] { 1, 2, 3 };

Помните, хотя в этом примере используются простые массивы байтов, обычно здесь используются допустимые XML и схема.

Шаг 3: Добавьте пользовательские XML-части

Теперь пришло время добавить ваши пользовательские XML-части в рабочую книгу. Вы можете сделать это, вызвавAdd метод наCustomXmlParts Сборник рабочей тетради.

// Создайте четыре пользовательских XML-части.
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);

Этот фрагмент кода добавляет четыре идентичных пользовательских XML-части в рабочую книгу. Вы можете настроить это в соответствии со своими требованиями.

Шаг 4: Назначение идентификаторов пользовательским частям XML

Теперь, когда у нас есть добавленные части XML, давайте дадим каждой из них уникальный идентификатор. Этот идентификатор поможет нам позже извлечь части XML.

//Назначьте идентификаторы пользовательским частям XML.
wb.CustomXmlParts[0].ID = "Fruit";
wb.CustomXmlParts[1].ID = "Color";
wb.CustomXmlParts[2].ID = "Sport";
wb.CustomXmlParts[3].ID = "Shape";

На этом этапе вы назначаете значимые идентификаторы, такие как «Фрукт», «Цвет», «Спорт» и «Форма». Это упрощает идентификацию и работу с соответствующими частями в дальнейшем.

Шаг 5: Укажите идентификатор поиска для пользовательской XML-части

Если вы хотите получить определенную часть XML, используя ее идентификатор, вам необходимо определить идентификатор, который вы ищете.

// Укажите идентификатор пользовательской части XML для поиска.
String srchID = "Fruit";
srchID = "Color";
srchID = "Sport";

В реальном приложении вы, скорее всего, захотите указать каждый идентификатор динамически, но в нашем примере мы жестко закодируем несколько.

Шаг 6: Поиск пользовательской XML-части по идентификатору

Теперь, когда у нас есть идентификаторы поиска, пришло время найти пользовательскую часть XML, соответствующую указанному идентификатору.

// Поиск пользовательской части XML по идентификатору поиска.
Aspose.Cells.Markup.CustomXmlPart cxp = wb.CustomXmlParts.SelectByID(srchID);

Эта линия используетSelectByID чтобы попытаться найти интересующую нас часть XML.

Шаг 7: Проверьте, найдена ли пользовательская часть XML

Наконец, нам нужно проверить, была ли найдена XML-часть, и вывести соответствующее сообщение на консоль.

// Вывести на консоль сообщение «Найден» или «Не найден».
if (cxp == null)
{
    Console.WriteLine("Not Found: CustomXmlPart ID " + srchID);
}
else
{
    Console.WriteLine("Found: CustomXmlPart ID " + srchID);
}
Console.WriteLine("AddCustomXMLPartsAndSelectThemByID executed successfully.");

Вы его раздавили! К этому моменту вы не только добавили пользовательские XML-части в свою рабочую книгу, но и реализовали функциональность для их поиска по идентификаторам.

Заключение

В этой статье мы рассмотрели, как добавлять пользовательские XML-части в книгу Excel с помощью Aspose.Cells for .NET. Следуя пошаговому руководству, вы смогли создать книгу, добавить пользовательские XML-части, назначить идентификаторы и эффективно их извлечь. Эта функциональность может быть невероятно полезной при работе с динамическими данными, которые необходимо обрабатывать в файлах Excel, делая ваши приложения более умными и способными.

Часто задаваемые вопросы

Что такое Aspose.Cells?

Aspose.Cells — это надежная библиотека .NET, которая позволяет разработчикам создавать, изменять и конвертировать файлы Excel без необходимости установки Microsoft Excel.

Могу ли я использовать Aspose.Cells бесплатно?

Да! Вы можете начать с бесплатной пробной версии. Простоскачать здесь.

Можно ли добавить несколько пользовательских частей XML в книгу?

Конечно! Вы можете добавить столько пользовательских частей XML, сколько вам нужно, и каждой из них можно присвоить уникальный идентификатор для легкого доступа.

Как мне получить части XML, если я не знаю идентификаторы?

Если вы не знаете идентификаторы, вы можете просмотреть ихCustomXmlParts коллекция для просмотра имеющихся деталей и их идентификаторов, что упрощает их идентификацию и доступ к ним.

Где я могу найти дополнительные ресурсы или поддержку для Aspose.Cells?

Вы можете проверитьдокументация для получения подробной информации или посетитефорум поддержки для помощи обществу.

Доступ к информации веб-расширения Excel с помощью Aspose.Cells Добавить цифровую подпись к подписанному файлу Excel