Postupy: Použití pojmenovaných a nepovinných argumentů v programování pro sadu Office (Průvodce programováním v C#)

Článek
06/10/2015

Pojmenované argumenty a volitelné argumenty, které jsou zavedeny v Visual C# 2010, zlepšit čitelnost v programování C#, pohodlí a flexibilitu. Tyto funkce navíc výrazně usnadnit přístup k rozhraní COM, jako je například Microsoft Office automation API.

V následujícím příkladu metoda ConvertToTable má šestnáct parametry, které představují vlastnosti tabulky, například počet sloupců a řádků, formátování, ohraničení, písma a barvy.Všechny šestnáct parametry jsou volitelné, protože většinu času chcete určit konkrétní hodnoty pro všechny.Však bez pojmenované a volitelné argumenty hodnotu nebo hodnotu zástupného textu musí být poskytnuty pro každý parametr.S pojmenovanými a volitelné argumenty zadáte pouze hodnoty parametrů, které jsou požadovány pro projekt.

Aplikace Microsoft Office Word, v počítači nainstalován k dokončení tohoto postupu musíte mít.

[!POZNÁMKA]

Na vašem počítači se můžou v následujících pokynech zobrazovat jiné názvy nebo umístění některých prvků uživatelského rozhraní Visual Studia. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Vytvoření nové aplikace konzoly

Spusťte aplikaci Visual Studio.
V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).
V Kategorie šablon podokně rozbalte položku **Visual C#**a klepněte na tlačítko Windows.
Oblast v horní části šablony podokně a ujistěte se, že .NET Framework 4 se zobrazí v Cílový rámec pole.
V podokně Šablony klikněte na Aplikace konzoly.
Zadejte název projektu název pole.
Klikněte na tlačítko OK.

Nový projekt se objeví v Aplikaci Solution Explorer.

Přidat odkaz

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na název projektu a klepněte na tlačítko Přidat odkaz na.Přidat odkaz na se zobrazí dialogové okno.
Na .NET stránky vyberte Microsoft.Office.Interop.Word v Název součásti seznam.
Klikněte na tlačítko OK.

Přidání nezbytné použití směrnic

V Aplikaci Solution Explorer, klepněte pravým tlačítkem myši Program.cs souboru a klepněte na tlačítko Zobrazení kódu.
Přidejte následující using směrnic na začátek souboru kódu.
```
using Word = Microsoft.Office.Interop.Word;
```

Zobrazení textu v dokumentu aplikace Word

V Program třídy v Program.cs, přidejte následující metodu vytváření aplikace Word a dokument aplikace Word.Přidat metoda má čtyři volitelné parametry.Tento příklad používá výchozí hodnoty.Proto jsou nezbytné v příkazu volající žádné argumenty.

static void DisplayInWord()
{
    var wordApp = new Word.Application();
    wordApp.Visible = true;
    // docs is a collection of all the Document objects currently  
    // open in Word.
    Word.Documents docs = wordApp.Documents;

    // Add a document to the collection and name it doc. 
    Word.Document doc = docs.Add();
}

Přidejte následující kód na konci metoda definovat umístění pro zobrazení textu v dokumentu a text zobrazit.

// Define a range, a contiguous area in the document, by specifying 
// a starting and ending character position. Currently, the document 
// is empty.
Word.Range range = doc.Range(0, 0);

// Use the InsertAfter method to insert a string at the end of the 
// current range.
range.InsertAfter("Testing, testing, testing. . .");

Spuštění aplikace

Hlavní přidáte následující prohlášení.
```
DisplayInWord();
```
Stiskněte kombinaci kláves CTRL + F5 spuštění projektu.Dokument aplikace Word se zobrazí obsahující zadaný text.

Změnit text na tabulku

Použití ConvertToTable metodou, uzavřete text do tabulky.Metoda má šestnáct volitelné parametry.Technologie IntelliSense ohraničuje volitelné parametry v závorkách, jak je znázorněno na následujícím obrázku.

Parametry ConvertToTable

Název a volitelné argumenty umožňují určit hodnoty pouze parametry, které chcete změnit.Přidejte následující kód na konec metody DisplayInWord vytvořit jednoduchou tabulku.Argument určuje čárkami v textu řetězec, v range oddělit buňky tabulky.
```
// Convert to a simple table. The table will have a single row with 
// three columns.
range.ConvertToTable(Separator: ",");
```
V dřívějších verzích jazyka C#, volání ConvertToTable vyžaduje argument odkaz pro každý parametr, jak je znázorněno v následujícím kódu.
```
// Call to ConvertToTable in Visual C# 2008 or earlier. This code 
// is not part of the solution. 
var missing = Type.Missing;
object separator = ",";
range.ConvertToTable(ref separator, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing);
```
Stiskněte kombinaci kláves CTRL + F5 spuštění projektu.

Experimentovat s jinými parametry

Chcete-li tabulku změnit tak, aby jeden sloupec a tři řádky, nahradit poslední řádek v DisplayInWord s následující příkaz a pak zadejte kombinaci kláves CTRL + F5.
```
range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);
```
Chcete-li zadat předdefinovaný formát tabulky nahradit poslední řádek v DisplayInWord s následující příkaz a pak zadejte kombinaci kláves CTRL + F5.Formát může být WdTableFormat konstanty.
```
range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1,
    Format: Word.WdTableFormat.wdTableFormatElegant);
```

Příklad

Následující kód obsahuje celý příklad.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Word = Microsoft.Office.Interop.Word;


namespace OfficeHowTo
{
    class WordProgram
    {
        static void Main(string[] args)
        {
            DisplayInWord();
        }

        static void DisplayInWord()
        {
            var wordApp = new Word.Application();
            wordApp.Visible = true;
            // docs is a collection of all the Document objects currently  
            // open in Word.
            Word.Documents docs = wordApp.Documents;

            // Add a document to the collection and name it doc. 
            Word.Document doc = docs.Add();

            // Define a range, a contiguous area in the document, by specifying 
            // a starting and ending character position. Currently, the document 
            // is empty.
            Word.Range range = doc.Range(0, 0);

            // Use the InsertAfter method to insert a string at the end of the 
            // current range.
            range.InsertAfter("Testing, testing, testing. . .");

            // You can comment out any or all of the following statements to 
            // see the effect of each one in the Word document. 

            // Next, use the ConvertToTable method to put the text into a table.  
            // The method has 16 optional parameters. You only have to specify 
            // values for those you want to change. 

            // Convert to a simple table. The table will have a single row with 
            // three columns.
            range.ConvertToTable(Separator: ",");

            // Change to a single column with three rows..
            range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);

            // Format the table.
            range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1,
                Format: Word.WdTableFormat.wdTableFormatElegant);
        }
    }
}

Viz také

Koncepty

Pojmenované a nepovinné argumenty (Průvodce programováním v C#)

Sdílet prostřednictvím