Добавление документа Word

1. Чтобы продемонстрировать дополнительные способы, совершенствующие программирование для Office в Visual C# 2010 и более поздних версиях, следующий код открывает приложение Word и создает значок со ссылкой на лист Excel.

Вставьте метод CreateIconInWordDoc, указанный далее в этом шаге, в класс Program. В методе CreateIconInWordDoc используются именованные и необязательные аргументы, чтобы упростить вызовы методов Add и PasteSpecial. Этих вызовах используются две новые возможности, появившиеся в Visual C# 2010 которые упрощают вызовы методов COM, имеющих ссылочные параметры. Во-первых, аргументы можно передать в ссылочные параметры, как если бы они были параметрами значений. Это значит, что значения можно передавать напрямую без создания переменной для каждого ссылочного параметра. Компилятор создает временные переменные для хранения значений аргументов и уничтожает эти переменные после завершения вызываемого метода. Во-вторых, ключевое слово ref в списке аргументов можно опустить.

У метода Add имеется четыре ссылочных параметра, все из которых являются необязательными. В Visual C# 2010 или более поздних версиях можно опустить аргументы для любого или для всех параметров, если требуется использовать значения по умолчанию. В Visual C# 2008 и более ранних версиях необходимо было указывать аргумент для каждого из параметров, и этот аргумент должен был быть переменной, поскольку параметры являются ссылочными.

Метод PasteSpecial вставляет содержимое буфера обмена. У метода имеется семь ссылочных параметров, все из которых являются необязательными. Следующий код задает аргументы для двух из них: Link для создания ссылки на исходное содержимое буфера иDisplayAsIcon для отображение ссылки в виде значка. В Visual C# 2010 можно использовать именованные аргументы для этих двух параметров и опустить остальные аргументы. Хотя эти параметры являются ссылочными, использовать ключевое слово ref или создавать переменные для передачи аргументов не требуется. Значения можно передать напрямую. В Visual C# 2008 и более ранних версиях необходимо было передавать аргумент в виде переменной для каждого ссылочного параметра.

C#.

static void CreateIconInWordDoc ().

{.

var wordApp = new Word. Application ();

wordApp.Visible = true;

// The Add method has four reference parameters, all of which are.

// optional. Visual C# 2010 allows you to omit arguments for them if.

// the default values are what you want.

wordApp.Documents.Add ();

// PasteSpecial has seven reference parameters, all of which are.

// optional. This example uses named arguments to specify values.

// for two of the parameters. Although these are reference.

// parameters, you do not need to use the ref keyword, or to create.

// variables to send in as arguments. You can send the values directly.

wordApp.Selection.PasteSpecial (Link: true, DisplayAsIcon: true);

}.

В Visual C# 2008 и более ранних версиях приходилось использовать следующий более сложный синтаксис.

C#.

static void CreateIconInWordDoc2008().

{.

var wordApp = new Word. Application ();

wordApp.Visible = true;

// The Add method has four parameters, all of which are optional.

// In Visual C# 2008 and earlier versions, an argument has to be sent.

// for every parameter. Because the parameters are reference.

// parameters of type object, you have to create an object variable.

// for the arguments that represents 'no value'.

object useDefaultValue = Type. Missing;

wordApp.Documents.Add (ref useDefaultValue, ref useDefaultValue,.

ref useDefaultValue, ref useDefaultValue);

// PasteSpecial has seven reference parameters, all of which are.

// optional. In this example, only two of the parameters require.

// specified values, but in Visual C# 2008 an argument must be sent.

// for each parameter. Because the parameters are reference parameters,.

// you have to contruct variables for the arguments.

object link = true;

object displayAsIcon = true;

wordApp.Selection.PasteSpecial (ref useDefaultValue,.

ref link,.

ref useDefaultValue,.

ref displayAsIcon,.

ref useDefaultValue,.

ref useDefaultValue,.

ref useDefaultValue);

}.

2. Добавьте в конец метода Main следующую инструкцию.

C#.

// Create a Word document that contains an icon that links to.

// the spreadsheet.

CreateIconInWordDoc ();

3. Добавьте в конец метода DisplayInExcel следующую инструкцию. Метод Copy добавляет лист в буфер обмена.

C#.

// Put the spreadsheet contents on the clipboard. The Copy method has one.

// optional parameter for specifying a destination. Because no argument.

// is sent, the destination is the Clipboard.

workSheet.Range["A1:B3"]. Copy ();

4. Нажмите клавиши CTRL+F5.

Появится документ Word, содержащий значок. Дважды щелкните значок, чтобы отобразить лист на переднем плане.