Parametry opcjonalne w rozwiązania dla pakietu Office
Wiele metod, w przypadku modeli obiektów aplikacji Microsoft Office akceptuje parametry opcjonalne.Jeśli używasz programu Visual Basic do opracowania rozwiązania pakietu Office w Visual Studio 2012, nie trzeba przekazać wartość dla parametrów opcjonalnych, ponieważ automatycznie używane są wartości domyślne dla każdego parametru brakuje.W większości przypadków można również pominąć parametry opcjonalne w projekty Visual C#. Jednakże nie można pominąć opcjonalne ref parametry z ThisDocument klasy w poziomie dokumentu programu Word projektów.
Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu i projektów na poziomie aplikacji dla pakietu Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.
Aby uzyskać więcej informacji na temat pracy z parametrów opcjonalnych w projekty Visual C# i Visual Basic, zobacz Argumenty nazwane i opcjonalne (Podręcznik programowania C#) i Parametry opcjonalne (Visual Basic).
[!UWAGA]
We wcześniejszych wersjach programu Visual Studio musi upłynąć wartość dla każdego parametru w projekty Visual C#.Dla wygody, projekty te obejmują zmienną globalną o nazwie missing że można przekazać parametr opcjonalny, gdy chcesz używać domyślnej wartości parametru.Projekty Visual C# dla pakietu Office w Visual Studio 2012 nadal to missing zmiennej, ale zazwyczaj nie trzeba używać go podczas opracowywania rozwiązań pakietu Office w Visual Studio 2012, z wyjątkiem przypadków, gdy wywołanie metody z opcjonalnym ref parametry w ThisDocument klasy w projektach 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ą w innych, jak pokazano w poniższym przykładzie kodu.W tym przykładzie wymaga projekt na poziomie dokumentu z klasy arkusza 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ą w innych, jak pokazano w poniższym 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ą opcjonalne parametry metody klasy ThisDocument w projektów systemu Visual C# poziomie dokumentu dla programu Word
Modelu obiektów programu Word zawiera wiele metod z opcjonalnym ref parametry, które akceptują Object wartości.Jednakże, nie można pominąć opcjonalne ref parametrów metod wygenerowany ThisDocument klasy w Visual C# projektów poziomie dokumentu dla programu Word.Visual C# pozwala pominąć opcjonalne ref tylko parametrów metod interfejsów, nie klas.Na przykład, poniższy kod nie kompiluje, ponieważ nie można pominąć opcjonalne ref parametry z CheckSpelling metoda ThisDocument klasy.
Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);
Po wywołaniu metody ThisDocument klasy, należy przestrzegać następujących zasad:
Aby zaakceptować wartość domyślną opcjonalny ref parametr, przebieg missing zmiennej do parametru.missing Zmienna jest automatycznie zdefiniowany w Visual C# Biura projektów i jest przypisany do wartości Type.Missing kod wygenerowany projekt.
Aby określić wartość dla opcji ref parametr, 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 pokazuje, jak wywołać CheckSpelling metoda, określając wartość dla ignoreUppercase parametr i przyjmowanie wartości domyślnej 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 pomija opcjonalne ref parametry metody w ThisDocument klasy, można również wywołać tę samą metodę w Microsoft.Office.Interop.Word.Document obiektu zwróconego przez InnerObject właściwość i pominąć pozostałe parametry z tej metody.Można to zrobić, ponieważ Microsoft.Office.Interop.Word.Document jest interfejs, a nie klasy.
Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Aby uzyskać więcej informacji na temat parametrów typ wartości i odniesienia, zobacz Przekazywanie argumentów przez wartość i przez odwołanie (Visual Basic) (dla języka Visual Basic) i Przekazywanie parametrów (Podręcznik programowania C#).
Zobacz też
Koncepcje
Pisania kodu w rozwiązania dla pakietu Office