Настройка форматов отображения с помощью пользовательских чисел

Введение

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

Предпосылки

Прежде чем начать, убедитесь, что у вас все готово для выполнения этого руководства. Вот что вам понадобится:

• Aspose.Cells для .NET установлен.Загрузить здесь.
• Базовые знания C# и .NET Framework.
• Действующая лицензия для Aspose.Cells. Если у вас ее нет, возьмитебесплатная пробная версия или запроситьвременная лицензия.
• IDE, подобная Visual Studio.
• .NET Framework 4.0 или выше. Если вам чего-то не хватает, не волнуйтесь. Вы всегда можете вернуться к этим ссылкам, чтобы загрузить необходимые файлы или обратиться за помощью кФорум поддержки Aspose.

Импорт пространств имен

Прежде чем приступить к написанию кода, вам необходимо импортировать требуемые пространства имен для доступа ко всем необходимым функциям Aspose.Cells.

using System.IO;
using Aspose.Cells;
using System;

Эти два пространства имен будут вашими основными инструментами в этом руководстве. Теперь перейдем к самой интересной части:

Шаг 1: Настройка каталога проекта

Во-первых, вам нужно место для хранения файлов, верно? Давайте создадим каталог для сохранения выходного файла Excel. На этом этапе мы также убедимся, что каталог существует, прежде чем что-либо сохранять.

// Путь к каталогу документов.
string dataDir = "Your Document Directory";
// Создайте каталог, если его еще нет.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

• Мы определяемdataDir переменная для хранения пути, по которому будет сохранен выходной файл Excel.
• Затем мы проверяем, существует ли каталог, используяSystem.IO.Directory.Exists().
• Если каталог не существует, он будет создан с помощьюSystem.IO.Directory.CreateDirectory().

Шаг 2: Создайте новую рабочую книгу и добавьте рабочий лист

Теперь, когда у нас есть каталог, давайте создадим новую книгу Excel и добавим в нее рабочий лист.

// Создание объекта Workbook
Workbook workbook = new Workbook();
// Добавление нового рабочего листа к объекту Excel
int i = workbook.Worksheets.Add();
// Получение ссылки на недавно добавленный рабочий лист путем передачи его индекса листа
Worksheet worksheet = workbook.Worksheets[i];

• Сначала мы создаем новыйWorkbook объект. Подумайте об этом как о вашем файле Excel.
• Мы добавляем новый рабочий лист в эту книгу с помощьюAdd()метод и сохранить индекс в переменнойi.
• Мы ссылаемся на этот рабочий лист, используяworkbook.Worksheets[i].

Шаг 3: Добавление даты в ячейку и настройка ее формата

Теперь давайте вставим текущую дату в ячейку и отформатируем ее для отображения в пользовательском виде. Вместо формата даты по умолчанию мы установим пользовательский формат, напримерd-mmm-yy.

// Добавление текущей системной даты в ячейку «A1»
worksheet.Cells["A1"].PutValue(DateTime.Now);
// Получение стиля ячейки А1
Style style = worksheet.Cells["A1"].GetStyle();
// Установка пользовательского формата отображения для отображения даты в виде «д-ммм-гг»
style.Custom = "d-mmm-yy";
// Применение стиля к ячейке А1
worksheet.Cells["A1"].SetStyle(style);

• Добавляем текущую системную дату в ячейкуA1 с использованиемPutValue(DateTime.Now).
• Мы извлекаем текущий стиль ячейкиA1 с использованиемGetStyle().
• Мы изменяем стиль ячейки, устанавливаяstyle.Custom = "d-mmm-yy", который форматирует дату, отображая день, сокращенный месяц и год.
• Наконец, мы применяем новый стиль к ячейке сSetStyle().

Шаг 4: Форматирование ячейки в виде процентов

Далее, давайте поработаем с числами. Мы добавим числовое значение в другую ячейку, скажемA2и отформатируйте его как процент.

//Добавление числового значения в ячейку «A2»
worksheet.Cells["A2"].PutValue(20);
// Получение стиля ячейки А2
style = worksheet.Cells["A2"].GetStyle();
// Настройка пользовательского формата отображения для отображения значения в процентах
style.Custom = "0.0%";
// Применение стиля к ячейке А2
worksheet.Cells["A2"].SetStyle(style);

• Мы добавляем ценность20 в ячейкуA2.
• Мы извлекаем стиль ячейкиA2 и установите пользовательский формат0.0% для отображения значения в процентах (например, 20%).
• Наконец, мы применяем стиль к ячейке с помощьюSetStyle().

Шаг 5: Форматирование ячейки как валюты

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

// Добавление числового значения в ячейку «A3»
worksheet.Cells["A3"].PutValue(2546);
// Получение стиля ячейки А3
style = worksheet.Cells["A3"].GetStyle();
// Настройка пользовательского формата отображения для отображения значения в виде валюты
style.Custom = "£#,##0;[Red]$-#,##0";
// Применение стиля к ячейке А3
worksheet.Cells["A3"].SetStyle(style);

• Мы добавляем ценность2546 в ячейкуA3.
• Мы устанавливаем индивидуальный формат£#,##0;[Red]$-#,##0, который отображает положительные значения со знаком решетки, а отрицательные значения — красным со знаком доллара.
• Применяем стиль к ячейке с помощьюSetStyle().

Шаг 6: Сохранение рабочей книги

Последний шаг — сохранить книгу как файл Excel. Для этого урока мы будем использовать формат Excel 97-2003.

// Сохранение файла Excel
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

• TheSave() метод сохраняет книгу в указанном каталоге.
• Мы выбираемSaveFormat.Excel97To2003 для обеспечения совместимости со старыми версиями Excel.

Заключение

Вот и все! Мы только что создали файл Excel, добавили пользовательские форматы даты, процентов и валюты в определенные ячейки с помощью Aspose.Cells для .NET и сохранили файл. Пользовательское форматирование делает ваши файлы Excel гораздо более читабельными и профессиональными. Не забудьте изучить другие параметры форматирования в Aspose.Cells, такие как условное форматирование, для еще большего контроля над тем, как выглядят ваши данные.

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

Как применить более сложные параметры форматирования в Aspose.Cells?

Вы можете комбинировать различные стили форматирования, такие как цвет шрифта, границ и цвета фона, с пользовательскими числовыми форматами.

Можно ли применить пользовательский числовой формат к диапазону ячеек?

Да, Aspose.Cells позволяет применять стиль к диапазону ячеек с помощьюRange.SetStyle() метод.

В каких еще форматах файлов я могу сохранить рабочую книгу?

Aspose.Cells поддерживает множество форматов, включая XLSX, CSV и PDF. Просто изменитеSaveFormat вSave() метод.

Можно ли форматировать отрицательные числа по-другому?

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

Является ли Aspose.Cells для .NET бесплатным?

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