Parametry opcjonalne w rozwiązaniach Office
Wiele metod w modeli obiektów aplikacji pakietu Microsoft Office akceptuje parametry opcjonalne.Jeśli używasz języka Visual Basic do opracowania rozwiązania pakietu Office w Visual Studio 2013, nie trzeba przekazać wartości dla parametrów opcjonalnych, ponieważ dla każdego parametru brak automatycznie są używane wartości domyślne.W większości przypadków można również pominąć parametry opcjonalne w projektach programu Visual C#.Jednak nie można pominąć opcjonalne ref parametry ThisDocument klasy w projektów na poziomie dokumentu programu Word.
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w pakietach Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.
Aby uzyskać więcej informacji na temat pracy z opcjonalnymi parametrami w projektach programu Visual C# i Visual Basic, zobacz Argumenty nazwane i opcjonalne (Przewodnik programowania w języku C#) i Parametry opcjonalne (Visual Basic).
[!UWAGA]
We wcześniejszych wersjach programu Visual Studio musi przekazać wartość dla każdego parametru w projektach programu Visual C#.Dla wygody, projekty te obejmują zmienną globalną o nazwie missing że można przekazać parametr opcjonalny chcąc używać domyślnej wartości parametru.Visual C# projektów biura w Visual Studio 2013 nadal to missing zmiennej, ale zazwyczaj nie trzeba używać go podczas opracowywania rozwiązań pakietu Office w Visual Studio 2013, z wyjątkiem przypadków, gdy wywołanie metody wyposażonym w opcjonalne ref parametry w ThisDocument klasy w projektów na poziomie dokumentu dla programu Word.
Przykład w programie Excel
Worksheet.CheckSpelling Metoda ma wiele parametrów opcjonalnych.Można określić wartości dla niektórych parametrów i zaakceptować wartość domyślną innych, jak pokazano w następującym przykładzie kodu.W tym przykładzie wymaga projektu poziomie dokumentu z arkusza klasę o nazwie Sheet1.
Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)
Globals.Sheet1.CheckSpelling(ignoreUppercase: true);
Przykład w programie Word
Find.Execute Metoda ma wiele parametrów opcjonalnych.Można określić wartości dla niektórych parametrów i zaakceptować wartość domyślną innych, jak pokazano w następującym przykładzie kodu.
With Me.Application.ActiveDocument.Content
.Find.ClearFormatting()
.Find.Execute(FindText:="blue", ReplaceWith:="red", Replace:=Word.WdReplace.wdReplaceAll)
End With
Word.Range documentRange = this.Application.ActiveDocument.Content;
documentRange.Find.ClearFormatting();
documentRange.Find.Execute(FindText: "blue", ReplaceWith: "red", Replace: Word.WdReplace.wdReplaceAll);
Za pomocą opcjonalnych parametrów metod klasy ThisDocument w środowisku Visual C# projektów na poziomie dokumentu dla programu Word
Modelu obiektów programu Word zawiera wiele metod wyposażonym w opcjonalne ref parametry, które akceptują Object wartości.Jednak nie można pominąć opcjonalne ref parametrów metod wygenerowanej ThisDocument klasy w poziomie dokumentu projektów programu Visual C# w programie Word.Program Visual C# pozwala pominąć opcjonalne ref parametry tylko dla metod interfejsy, nie klasy.Na przykład, poniższy kod nie kompiluje, ponieważ nie można pominąć opcjonalne ref parametry CheckSpelling metody ThisDocument klasy.
Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);
Gdy wywołanie metody ThisDocument klasę, należy przestrzegać następujących zasad:
Aby zaakceptować domyślną wartość opcjonalny ref parametr, przebieg missing zmiennej do parametru.missing Zmienna jest definiowana automatycznie w projektach programu Visual C# pakietu Office i jest przypisany do wartości Type.Missing w kodzie wygenerowany projekt.
Aby określić własną wartość opcjonalny ref parametru, zadeklarować obiektu, który jest przypisany do wartości, które chcesz określić, a następnie przekazać obiektu do parametru.
Poniższy przykład kodu demonstruje sposób wywoływania CheckSpelling metoda, określając wartość dla ignoreUppercase parametr i akceptuje wartości domyślne dla innych parametrów.
object ignoreUppercase = true;
Globals.ThisDocument.CheckSpelling(
ref missing, ref ignoreUppercase, ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing, ref missing, ref missing);
Jeśli chcesz napisać kod, który umożliwia pominięcie opcjonalne ref parametry metody w ThisDocument klasy, można również wywołać tę samą metodę w Document obiektu zwróconego przez InnerObject właściwość i pominąć pozostałe parametry z tej metody.Można to zrobić, ponieważ Document jest interfejsem, a nie klasy.
Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Aby uzyskać więcej informacji dotyczących parametrów typu wartość i odniesienia, zobacz Przekazywanie argumentów według wartości i według odwołania (Visual Basic) (dla Visual Basic) i Przekazywanie parametrów (Przewodnik programowania w języku C#).
Zobacz też
Koncepcje
Pisanie kodu dla rozwiązań pakietu Office