Как создать надстройку автоматизации в реальном времени в C# с помощью RtdServer?
Мне было поручено написать надстройку для автоматизации Excel в режиме реального времени на C#, используя RtdServer для работы. Я сильно полагался на знания, с которыми я столкнулся в Stack Overflow. Я решил выразить свою благодарность, написав, как документ, который связывает воедино все, что я узнал. RTD-серверы Excel Кенни Керра : статья о минимальной реализации C# помогла мне начать работу. Особенно полезными оказались комментарии Mike Rosenblum и Govert.
3 ответа
(В качестве альтернативы подходу, описанному ниже, вам следует рассмотреть возможность использования Excel-DNA. Excel-DNA позволяет вам создать RTD-сервер без регистрации. COM-регистрация требует административных привилегий, которые могут привести к головным болям при установке. При этом код ниже работает отлично.)
Чтобы создать надстройку автоматизации в реальном времени в C# с помощью RtdServer:
1) Создайте проект библиотеки классов C# в Visual Studio и введите следующее:
using System;
using System.Threading;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using Microsoft.Office.Interop.Excel;
namespace Stackru
{
public class Countdown
{
public int CurrentValue { get; set; }
}
[Guid("EBD9B4A9-3E17-45F0-A1C9-E134043923D3")]
[ProgId("Stackru.RtdServer.ProgId")]
public class RtdServer : IRtdServer
{
private readonly Dictionary<int, Countdown> _topics = new Dictionary<int, Countdown>();
private Timer _timer;
public int ServerStart(IRTDUpdateEvent rtdUpdateEvent)
{
_timer = new Timer(delegate { rtdUpdateEvent.UpdateNotify(); }, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
return 1;
}
public object ConnectData(int topicId, ref Array strings, ref bool getNewValues)
{
var start = Convert.ToInt32(strings.GetValue(0).ToString());
getNewValues = true;
_topics[topicId] = new Countdown { CurrentValue = start };
return start;
}
public Array RefreshData(ref int topicCount)
{
var data = new object[2, _topics.Count];
var index = 0;
foreach (var entry in _topics)
{
--entry.Value.CurrentValue;
data[0, index] = entry.Key;
data[1, index] = entry.Value.CurrentValue;
++index;
}
topicCount = _topics.Count;
return data;
}
public void DisconnectData(int topicId)
{
_topics.Remove(topicId);
}
public int Heartbeat() { return 1; }
public void ServerTerminate() { _timer.Dispose(); }
[ComRegisterFunctionAttribute]
public static void RegisterFunction(Type t)
{
Microsoft.Win32.Registry.ClassesRoot.CreateSubKey(@"CLSID\{" + t.GUID.ToString().ToUpper() + @"}\Programmable");
var key = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(@"CLSID\{" + t.GUID.ToString().ToUpper() + @"}\InprocServer32", true);
if (key != null)
key.SetValue("", System.Environment.SystemDirectory + @"\mscoree.dll", Microsoft.Win32.RegistryValueKind.String);
}
[ComUnregisterFunctionAttribute]
public static void UnregisterFunction(Type t)
{
Microsoft.Win32.Registry.ClassesRoot.DeleteSubKey(@"CLSID\{" + t.GUID.ToString().ToUpper() + @"}\Programmable");
}
}
}
2) Щелкните правой кнопкой мыши по проекту и выберите "Добавить"> "Новый элемент"> "Класс установщика". Переключитесь в режим просмотра кода и введите следующее:
using System.Collections;
using System.ComponentModel;
using System.Diagnostics;
using System.Runtime.InteropServices;
namespace Stackru
{
[RunInstaller(true)]
public partial class RtdServerInstaller : System.Configuration.Install.Installer
{
public RtdServerInstaller()
{
InitializeComponent();
}
[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Commit(IDictionary savedState)
{
base.Commit(savedState);
var registrationServices = new RegistrationServices();
if (registrationServices.RegisterAssembly(GetType().Assembly, AssemblyRegistrationFlags.SetCodeBase))
Trace.TraceInformation("Types registered successfully");
else
Trace.TraceError("Unable to register types");
}
[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Install(IDictionary stateSaver)
{
base.Install(stateSaver);
var registrationServices = new RegistrationServices();
if (registrationServices.RegisterAssembly(GetType().Assembly, AssemblyRegistrationFlags.SetCodeBase))
Trace.TraceInformation("Types registered successfully");
else
Trace.TraceError("Unable to register types");
}
public override void Uninstall(IDictionary savedState)
{
var registrationServices = new RegistrationServices();
if (registrationServices.UnregisterAssembly(GetType().Assembly))
Trace.TraceInformation("Types unregistered successfully");
else
Trace.TraceError("Unable to unregister types");
base.Uninstall(savedState);
}
}
}
3) Щелкните правой кнопкой мыши свойства проекта и отметьте следующее: Приложение> Информация о сборке...> Сделать сборку видимой и сделать сборку> Зарегистрироваться для взаимодействия COM
3.1) Щелкните правой кнопкой мыши на проекте Add Reference...>.NET tab> Microsoft.Office.Interop.Excel
4) Построить решение (F6)
5) Запустите Excel. Перейдите в Параметры Excel> Надстройки> Управление надстройками Excel> Автоматизация и выберите "Stackru.RtdServer"
6) Введите "=RTD("Stackru.RtdServer.ProgId",,200)" в ячейку.
7) Скрестите пальцы и надейтесь, что это работает!
Вызов UpdateNotify из потока таймера в конечном итоге приведет к странным ошибкам или отключениям от Excel.
Метод UpdateNotify() должен вызываться только из того же потока, который вызывает ServerStart(). Это не документировано в справке RTDServer, но это ограничение COM.
Исправить это просто. Используйте DispatcherSynchronizationContext для захвата потока, который вызывает ServerStart, и используйте его для отправки вызовов UpdateNotify:
public class RtdServer : IRtdServer
{
private IRTDUpdateEvent _rtdUpdateEvent;
private SynchronizationContext synchronizationContext;
public int ServerStart( IRTDUpdateEvent rtdUpdateEvent )
{
this._rtdUpdateEvent = rtdUpdateEvent;
synchronizationContext = new DispatcherSynchronizationContext();
_timer = new Timer(delegate { PostUpdateNotify(); }, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
return 1;
}
// Notify Excel of updated results
private void PostUpdateNotify()
{
// Must only call rtdUpdateEvent.UpdateNotify() from the thread that calls ServerStart.
// Use synchronizationContext which captures the thread dispatcher.
synchronizationContext.Post( delegate(object state) { _rtdUpdateEvent.UpdateNotify(); }, null);
}
// etc
}
После двух предыдущих ответов для RTD-сервера у меня сработало. Однако, я столкнулся с проблемой, когда на машине x64 работает Excel x64. В моем случае, пока я не переключил "целевую платформу" проекта на x64, Excel всегда показывал #N/A.