Александр Шабля
дата публикации 24-05-2006 07:46
В примерах используется раннее связывание (что это такое можно почитать здесь). Минимальная версия офиса — 2000 (9.0). Примеры для C# иногда не будут встречаться, когда есть примеры на MSDN http://msdn.microsoft.com/netframework/ или код на Delphi и C# практически одинаковый (не учитывая языковую специфику). Также в коде используются классы-наследники TOleServer: TExcelApplication, TExcelWorkbook и т.д. Константа lcid в примерах определена так:
const
lcid = LOCALE_USER_DEFAULT;
|
|
Excel.Application
Excel Range Object
Как загрузить новый экземпляр Excel или подключиться к запущенному экземпляру EXCEL.EXE? Как отсоединиться от Excel и закрыть его экземпляр?
Для определения будет ли запущен новый экземпляр Excel.Application или присоединение к уже запущенному, используется свойство TExcelApplication.ConnectKind. По умолчанию это свойство имеет значение ckRunningOrNew (константы определены в unit OleServer). Однако рекомендуется, если нет на то особой надобности, всегда запускать новый экземпляр Excel.Application во избежание конфликтов с запущенным раннее экземпляром Excel.Application. Свойство TExcelApplication.AutoQuit в конструкторе устанавливается по умолчанию в False (только в модуле ExcelXP в True) — это значит, что если вы хотите при отсоединении завершить работу Excel (закрыть), то нужно вызвать метод TExcelApplication.Quit или установить свойство TExcelApplication.AutoQuit равным True.
Delphi:
var
XL: TExcelApplication;
begin
XL := TExcelApplication.Create(nil);
try
XL.ConnectKind := ckNewInstance;
XL.Connect;
XL.AutoQuit := False;
XL.Visible[lcid] := True;
finally
XL.UserControl := True;
XL.Quit;
XL.Disconnect;
FreeAndNil(XL);
end;
|
|
С#
private Excel.Application StartExcel(bool asNewInstance)
{
Excel.Application XL = null;
if (!(asNewInstance)) {
try {
XL = System.Runtime.InteropServices.Marshal.GetActiveObject("Excel.Application")
as Excel.Application;
}
catch {
// XL = null;
}
}
if (XL == null) XL = new Excel.Application();
if (XL.Workbooks.Count == 0) XL.Workbooks.Add(Type.Missing);
XL.Visible = true;
return XL;
}
private void FinishExcel(Excel.Application XL)
{
if (XL != null) {
XL.ScreenUpdating = true;
if (! XL.Interactive) XL.Interactive = true;
XL.UserControl = true;
if (XL.Workbooks.Count == 0) {
XL.Quit();
}
else {
if (! XL.Visible) XL.Visible = true;
XL.ActiveWorkbook.Saved = true;
}
// System.Runtime.InteropServices.Marshal.ReleaseComObject(XL);
XL = null;
GC.GetTotalMemory(true); // вызов сборщика мусора
// Пока не закрыть приложение EXCEL.EXE будет висеть в процессах
}
}
|
|
How to automate Microsoft Excel from Microsoft Visual C# .NET
How to use Visual C# to automate a running instance of an Office program
GC.GetTotalMemory Method
GC Class
Как запустить Excel из консольного приложения или в отдельном потоке (TThread)
Консольное приложение и дочерний поток (класс TThread) не предполагают работу с COM сервером, как это сделано в главном потоке для Application в VCL. Для того чтобы все работало, необходим вызов функции WinAPI CoInitialize.
var
NeedToUninitialize: Boolean;
…
begin
NeedToUninitialize := Succeeded(CoInitializeEx(nil, COINIT_MULTITHREADED));
try
finally
if NeedToUninitialize then CoUninitialize;
end;
end.
|
|
Отличие при работе в Thread — весь код работы должен быть помещен в метод TThread.Execute.
Для C# ничего дополнительно вызывать не нужно — все работает, что для WinForms, что для Console, что для объекта класса Thread().
CoInitializeEx
OleInitialize
Как получить и настроить папки Excel по умолчанию?
По умолчанию все открываемые и сохраняемые документы находятся в папке "%USERPROFILE%Мои документы" (Personal). Ссылка на эту папку содержится в свойстве TExcelApplication.DefaultFilePath (read/write). Для чтения и записи в другие папки используйте полный путь к файлу книги.
Delphi
(XL.ActiveSheet as _Worksheet).Range['A1', EmptyParam].Formula :=
Format('DefaultFilePath: %s', [XL.DefaultFilePath[lcid]]);
|
|
DefaultFilePath Property
How to: Set the Default Save Path for Workbooks
Чем отличается TExcelApplication от ExcelApplication, TExcelWorkbook от ExcelWorkbook?
Все отличие TExcelApplication от ExcelApplication в том, что первый — наследник TOleServer. Это расширяет возможности для выбора способа подключения/отключения COM-сервера Excel и упрощает работу с событиями Excel.Application. Получить интерфейс ExcelApplication всегда можно из свойства TExcelApplication.DefaultInterface (DefaultInterface — штатное свойство всех наследников класса ToleServer).
Как узнать локализацию Excel'я (русская версия или нет)?
Для Delphi это можно почитать здесь.
C#
oSheet.get_Range("A1", Type.Missing).Value2 =
XL.LanguageSettings.get_LanguageID(
Microsoft.Office.Core.MsoAppLanguageID.msoLanguageIDUI);
|
|
LanguageSettings Object
Как сделать, чтоб Excel работал быстрее?
Для ускорения работы с Excel'ем можно сделать следующие шаги:
Delphi:
XL.ScreenUpdating[lcid] := False;
XL.Calculation[lcid] := xlManual;
with XL.ErrorCheckingOptions do begin
BackgroundChecking := False;
NumberAsText := False;
InconsistentFormula := False;
end;
|
|
Не использовать метод Select, и, как следствие, свойство Selection (смотрите дальше).
Существенно повышается скорость, если вместо записи в каждую ячейку использовать запись из VarArray (смотрите дальше про объект Range). В Demo-проекте есть тест затраченного времени для различных методов записи.
Так как основное время работы с Excel'ем затрачивается на перерисовку (установка отступов для страницы, размеров строк и столбцов, атрибуты шрифтов и т.д.), то лучше всего использовать, заранее подготовленный, шаблон.
Как вывести приложение Excel на передний план?
Для "выноса" приложения Excel на передний план просто вызовите метод Visible объекта ExcelApplication.
Delphi
XL.Visible[lcid] := True;
SetForegroundWindow(XL.Hwnd);
|
|
C#
Как сделать так, чтоб работали английские формулы и форматы чисел в ячейках?
Решение для Delphi здесь "Русский Excel и установка NumberFormat"
К сожалению при работе с русским Excel'ем из C# проблемы те же, но, к счастью, решаются проще — через CultureInfo:
C#
int savedCult = Thread.CurrentThread.CurrentCulture.LCID;
try {
// установим английскую "культуру"
Thread.CurrentThread.CurrentCulture = new CultureInfo(0x0409, false);
Thread.CurrentThread.CurrentUICulture = new CultureInfo(0x0409, false);
// здесь работаем с Excel'ем, при чем работают английские формулы, DataFormat
// и колонтитулы в PageSetup
finally {
// восстановим пользовательскую "культуру" для отображения всех данных в
// привычных глазу форматах
Thread.CurrentThread.CurrentCulture = new CultureInfo(savedCult, true);
Thread.CurrentThread.CurrentUICulture = new CultureInfo(savedCult, true);
}
|
|
Русский Excel и установка NumberFormat
How to: Set the Culture and UI Culture for Windows Forms Globalization
Что такое Selection?
Как пишут в "Best Practices for Setting Range Properties": "Код использующий Selection сгенерирован записью макроса Excel, часто используется для обнаружения объекта или метода, который будет работать. Это хорошая идея, за исключением того, что записанный макрос не оптимизирован для пользователя. Обычно Excel при записи макроса использует Selection и изменяет выбор объекта при записи какой либо задачи". Т.е. использование Selection не является обязательным и даже не рекомендуется для разработчика. Цитата оттуда же: "На практике вызывайте метод Select объекта только тогда, когда твердо намерены изменить выбранный пользователем элемент. Вы можете никогда не использовать метод Select просто потому, что это вам удобно, как разработчику. Если вы устанавливаете свойства объекта Range у вас всегда есть альтернатива. Отказ от метода Select не только делает ваш код быстрее , но и порадует пользователей вашей программы (it makes your users happier)". Эта тема еще затронута здесь.
Selection Property
Почему не нужно использовать Excel.Application.Range, а следует ExcelWorksheet.Range?
Использование ExcelApplication.Range позволяет работать только с активным листом активной книги, если вы открываете по ходу работы еще одну книгу или делаете активным другой лист в книге (например, добавляете новый лист), то данные будут вноситься именно в активный в данный момент лист. Чтоб не попасть в неудобную ситуацию всегда используйте объект Range объекта ExcelWorksheet. Это не только обезопасит ваш код от попадания "куда Бог пошлет", но и позволит записывать данные сразу в несколько листов и даже книг без изменения ActiveSheet и ActiveCell.
Если приложение Excel работает и пользователь выполняет в Excel, одновременно, какие либо действия, то попытка подключится к Excel и вносить в него данные, вызывает ошибку. Как этого избежать?
При работе с запущенным приложением Excel, он может быть занят, если в это время пользователь редактирует значение в ячейке, или в нем открыт какой либо модальное диалоговое окно (например, "Открытие документа"). Чтоб обойти эту ситуацию всегда запускайте новую копию Excel.Application и устанавливайте свойство Interactive в False, что запретит пользователю что-либо делать в Excel'е или закрыть запущенный экземпляр Excel.Application:
Delphi
XL := TExcelApplication.Create(nil);
try
XL.ConnectKind := ckNewInstance;
XL.Connect;
XL.Interactive[lcid] := False;
XL.Visible[lcid] := True;
finally
XL.UserControl := True;
XL.Interactive[lcid] := True;
XL.Disconnect;
FreeAndNil(XL);
end;
|
|
The action cannot be completed because Microsoft Office Excel is busy
Interactive Property
Экспорт в Excel длится довольно долго. Как можно уведомлять пользователя о ходе выполнения работы?
Чтобы пользователь не подумал что во время экспорта данных в Excel ваша программа и Excel "висит", лучше уведомлять его о ходе работы. Т.к. обновление экрана занимает довольно много времени и так довольно длительного процесса экспорта (хотя все же стоит подумать, как этот процесс оптимизировать и ускорить), то лучшим выходом из этой ситуации является показ этапов работы в свойстве ExcelApplication.StatusBar:
Delphi
XL.DisplayStatusBar[lcid] := True;
XL.StatusBar[lcid] := 'Читаем';
XL.StatusBar[lcid] := 'Пишем';
XL.StatusBar[lcid] := 'Считаем';
XL.StatusBar[lcid] := False;
|
|
C#
XL.DisplayStatusBar = true;
//
XL.StatusBar = "Текст в статусбаре";
//
XL.StatusBar = false; // "Готово"
|
|
DisplayStatusBar Property
StatusBar Property
Переношу записанный VBA макрос рисования границы в Excel, но Delphi не знает что такое xlContinuous. Где взять значение этой константы?
Это всего лишь значит, что вы пользуетесь в Delphi поздним связыванием. Добавьте в uses ExcelXP или Excel2000. Для C# нужно полностью указывать namespace, тип и имя этой константы, например Excel.XlLineStyle.xlContinuous.
Microsoft.Office.Interop.Excel Namespace
Почему я не могу найти описание компонентов палитры Delphi "Servers" в Help'е? Где найти документацию по работе с Excel'ем?
Компоненты на палитре "Servers" — это "обертка" (wrapper) популярных COM-серверов Microsoft. Для описания их объектной модели, свойств и методов используйте поставляемый с Microsoft Office VBA Help или ищите информацию на MSDN (также смотрите "Полезные ссылки" в конце).
Microsoft Excel Object Model
Automating Excel Using the Excel Object Model
Office Development — Excel
Migrating Excel VBA Solutions to Visual Studio 2005 Tools for Office
Converting Microsoft Office VBA Macros to Visual Basic .NET and C#
Microsoft Excel 2003 Language Reference
Understanding the Excel Object Model from a .NET Developer's Perspective
Microsoft.Office.Interop.Excel Namespace
Excel Objects
Code Examples for Excel (C#)
[TExcelApplication] [Работа с Excel]
 Обсуждение материала [ 12-11-2008 05:07 ] 3 сообщения | 
