Рекомендации по передаче параметров в Microsoft Visual Studio Tools для Office (VSTO) 3 (C#)

Многие параметры для взаимодействия с объектной моделью Office в VSTO требуют параметров объекта, которые передаются по ссылке, даже если условным типом параметра является int или строка.

  1. Я полагаю, что этот механизм используется для того, чтобы код мог изменять параметр, хотя я не могу понять, почему их нужно передавать как общий объект, а не как их более подходящие типы. Кто-нибудь может меня просветить?
  2. Механизм, который я использовал (заимствованный из справки и ресурсов MSDN), по сути, создает общий объект, который содержит соответствующие данные, а затем передает их методу, например:

    объект nextBookmarkName = "NextContent"; объект nextBookmark = this.Bookmarks.get_Item (ref nextBookmarkName) .Range;

    Microsoft.Office.Interop.Word.Range newRng = this.Range (ref nextBookmark, ref nextBookmark);

Кажется, что это слишком много лишнего кода, но я не вижу лучшего способа сделать это. Я уверен, что что-то упускаю; что это такое? Или это действительно лучшая практика?

Это особенно неприятно в C#, где необязательные параметры запрещены, поэтому мне приходится часто использовать "ref missing" в качестве параметра.

cori 16.09.2008 21:22
Стоит ли изучать PHP в 2026-2027 годах?
Стоит ли изучать PHP в 2026-2027 годах?
Привет всем, сегодня я хочу высказать свои соображения по поводу вопроса, который я уже много раз получал в своем сообществе: "Стоит ли изучать PHP в...
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
В JavaScript одним из самых запутанных понятий является поведение ключевого слова "this" в стрелочной и обычной функциях.
Приемы CSS-макетирования - floats и Flexbox
Приемы CSS-макетирования - floats и Flexbox
Здравствуйте, друзья-студенты! Готовы совершенствовать свои навыки веб-дизайна? Сегодня в нашем путешествии мы рассмотрим приемы CSS-верстки - в...
Тестирование функциональных ngrx-эффектов в Angular 16 с помощью Jest
В системе управления состояниями ngrx, совместимой с Angular 16, появились функциональные эффекты. Это здорово и делает код определенно легче для...
Концепция локализации и ее применение в приложениях React ⚡️
Концепция локализации и ее применение в приложениях React ⚡️
Локализация - это процесс адаптации приложения к различным языкам и культурным требованиям. Это позволяет пользователям получить опыт, соответствующий...
Пользовательский скаляр GraphQL
Пользовательский скаляр GraphQL
Листовые узлы системы типов GraphQL называются скалярами. Достигнув скалярного типа, невозможно спуститься дальше по иерархии типов. Скалярный тип...
1
1
2 091
4
Перейти к ответу Данный вопрос помечен как решенный

Ответы 4

Меня это тоже заинтересует. Я пишу несколько приложений, которые используют автоматизацию в Word, и у меня даже есть такие вещи, как

object oFalse = false, oTrue = true, oOne = 1;

Это очень неприятно, но пока что это единственный способ, который я знаю.

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

Ответ принят как подходящий

Я думаю, это был просто плохой дизайн исходной объектной модели Word. Я знаю, что передача строк по ссылке может быть немного быстрее в мире COM, потому что это позволяет избежать необходимости делать копию, так что, возможно, это было частью оправдания. Но недостатком является то, что вызываемый объект может изменять значение, и в большинстве случаев с Word они являются входными параметрами.

Я считаю, что ваша техника - лучшая практика. Для миллионов необязательных параметров, которые требуются многим методам объектной модели Word, вы можете создать одно статическое поле, в котором «отсутствует» что-то вроде:

объект отсутствует = Type.Missing;

// Пример объект fileName = ... document.SaveAs (ref имя_файла, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует, ссылка отсутствует);

Вот чего я боялся. И FWIW, C# VSTO (я не знаю о VB.Net, так как никогда не использовал его) уже включает встроенный отсутствующий объект

cori 17.09.2008 06:33

Я согласен с Джо. Я даже разработал вспомогательные структуры и классы вроде этого:

internal struct Argument
{
    internal static object False = false;

    internal static object Missing = System.Type.Missing;

    internal static object True = true;
}

И этот:

/// <summary>
/// Defines the "special characters"
/// in Microsoft Word that VSTO 1.x
/// translates into C# strings.
/// </summary>
internal struct Characters
{
    /// <summary>
    /// Word Table end-of-cell marker.
    /// </summary>
    /// <remarks>
    /// Word Table end-of-row markers are also
    /// equal to this value.
    /// </remarks>
    internal static string CellBreak = "\r\a";

    /// <summary>
    /// Word line break (^l).
    /// </summary>
    internal static string LineBreak = "\v";

    /// <summary>
    /// Word Paragraph break (^p).
    /// </summary>
    internal static string ParagraphBreak = "\r";
}

И еще несколько ...

Я думаю, обо всем этом позаботились VS.NET 2010 и новые языковые конструкции, представленные в C# 4.0 (в C# будут необязательные аргументы).

Смотрите видео Андерса Хейлберга на PDC 2008 на канале 9, чтобы узнать об изменениях, связанных с офисным развитием.

Я не могу найти эту ссылку, но это тоже может быть полезно. http://channel9.msdn.com/shows/Going+Deep/Inside-C-40-dynamic-type-optional-parameters-more-COM-friendly/

Другие вопросы по теме