Porady: użycie argumentów nazwanych i opcjonalnych w programowaniu Office (Przewodnik programowania w języku C#)

O nazwie argumentów i argumentów opcjonalnych, wprowadzone w Visual C# 2010, zwiększenia wygody, elastyczność i czytelność programowania C#. Ponadto te funkcje znacznie ułatwić dostęp do interfejsów COM, takie jak automatyzacji programu Microsoft Office interfejsów API.

W poniższym przykładzie, Metoda ConvertToTable ma szesnaście parametry, które reprezentują właściwości tabeli, takich jak liczba kolumn i wierszy, formatowanie, obramowania, czcionki i kolory.Wszystkie parametry szesnaście są opcjonalne, ponieważ w większości przypadków nie chcesz określać wartości określonej dla nich wszystkich.Jednakże bez argumentów nazwanych i opcjonalna wartość lub symbol zastępczy ma dostarczane dla każdego parametru.Z argumentami nazwanego i opcjonalnie określisz wartości tylko dla parametrów, które są wymagane dla projektu.

Muszą mieć program Microsoft Office Word, zainstalowane na komputerze do wykonania tych procedur.

[!UWAGA]

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Aby utworzyć nową aplikację konsoli

1. Uruchom program Visual Studio.

2. Na pliku menu, wskaż Nowy, a następnie kliknij przycisk Projekt.

3. W Kategorie szablonów okienku rozwiń Visual C#, a następnie kliknij przycisk Windows.

4. Szukaj w górnej części szablonów okienka, aby upewnić się, że .NET Framework 4 pojawia się w Ramach docelowej pole.

5. W szablonów okienka, kliknij Console Application.

6. Wpisz nazwę projektu w Nazwa pola.

7. Click OK.

   Nowy projekt pojawia się w Solution Explorer.

Aby dodać odwołanie

1. W Solution Explorer, kliknij prawym przyciskiem myszy nazwę projektu, a następnie kliknij przycisk Dodaj odwołanie.Dodaj odwołanie pojawi się okno dialogowe.

2. Na .NET stronę, wybierz opcję Microsoft.Office.Interop.Word w Nazwa składnika listy.

3. Click OK.

Aby dodać niezbędne, za pomocą dyrektyw

1. W Solution Explorer, kliknij prawym przyciskiem myszy Plik Program.cs pliku, a następnie kliknij przycisk Widok Kod.

2. Dodaje się using dyrektyw do początku pliku kodu.

   using Word = Microsoft.Office.Interop.Word;
   

Aby wyświetlić tekst w dokumencie programu Word

1. W Program klasy w plik Program.cs, dodaj następującą metodę tworzenia aplikacji Word i dokumentu programu Word.Dodać metoda ma cztery parametry opcjonalne.W przykładzie użyto wartości domyślnych.W związku z tym argumenty nie są konieczne w instrukcji wywołującego.

   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();
   }
   

2. Dodaj następujący kod na koniec metoda zdefiniowanie, gdzie do wyświetlania tekstu w dokumencie i w jaki tekst do wyświetlenia.

   // 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. . .");
   

Aby uruchomić aplikację

1. Należy dodać następującą instrukcję głównego.

   DisplayInWord();
   

2. Naciśnij kombinację klawiszy CTRL + F5, aby uruchomić projekt.Dokument programu Word jest wyświetlany zawierający określony tekst.

Aby zmienić tekst na tabelę

1. Użyj ConvertToTable metody, należy ująć tekst w tabeli.Metoda ma szesnaście parametry opcjonalne.Technologia IntelliSense otacza opcjonalne parametry w nawiasach, jak pokazano na poniższej ilustracji.

   Parametry ConvertToTable

   

   O nazwie i argumentów opcjonalnych pozwalają określić wartości dla parametrów, które chcesz zmienić.Dodaj następujący kod do końca metody DisplayInWord , aby utworzyć prostą tabelę.Określa argument, że przecinkami w tekście string w range oddzielnych komórkach tabeli.

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

   We wcześniejszych wersjach języka C#, wywołanie do ConvertToTable wymaga argumentu odniesienie, dla każdego parametru, jak pokazano w poniższym kodzie.

   // 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);
   

2. Naciśnij kombinację klawiszy CTRL + F5, aby uruchomić projekt.

Aby poeksperymentować z innych parametrów

1. Aby zmienić tabeli ma jedną kolumnę i trzy wiersze, należy zastąpić ostatniej linii w DisplayInWord z następującej instrukcji, a następnie wpisz znak CTRL + F5.

   range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);
   

2. Aby określić format wstępnie zdefiniowanych dla tabeli, Zamień ostatniej linii w DisplayInWord z następującej instrukcji, a następnie wpisz znak CTRL + F5.Format może być dowolny z WdTableFormat stałych.

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

Przykład

Poniższy kod zawiera pełny przykład.

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);
        }
    }
}

Zobacz też

Koncepcje

Argumenty nazwane i opcjonalne (Przewodnik programowania w języku C#)