Volitelné parametry v řešeních pro systém Office
Mnoho metod objektových modelů aplikace Microsoft Office zadat volitelné parametry.Pokud používáte Visual Basic vyvinout řešení aplikace sady Office v Visual Studio 2013, není nutné předat hodnoty pro volitelné parametry, protože jsou automaticky použity výchozí hodnoty pro každý parametr nebyl nalezen.Ve většině případů můžete také vynechat volitelné parametry v jazyce Visual C# projekty.Však nelze vynechat volitelné ref parametry ThisDocument třídy v úrovni dokumentu projekty aplikace Word.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v Office 2013 a v Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
Další informace o práci s nepovinnými parametry v projekty Visual C# a Visual Basic naleznete v tématu Pojmenované a nepovinné argumenty (Průvodce programováním v C#) a Volitelné parametry (Visual Basic).
[!POZNÁMKA]
V dřívějších verzích sady Visual Studio musí předat hodnotu pro každý volitelný parametr v jazyce Visual C# projekty.Pro pohodlí, tyto projekty zahrnují globální proměnnou s názvem missing , že lze předat volitelný parametr Pokud chcete použít výchozí hodnotu parametru.Projekty Visual C# pro sadu Office v Visual Studio 2013 stále patří missing proměnné, ale obvykle není nutné používat při vývoji řešení Microsoft Office v Visual Studio 2013, s výjimkou při volání metody s volitelnou ref parametry v ThisDocument třídy v úrovni dokumentu projekty pro aplikaci Word.
Například v aplikaci Excel
Worksheet.CheckSpelling Metoda má mnoho volitelných parametrů.Můžete zadat hodnoty pro některé parametry a přijměte výchozí hodnotu ostatních, jak je znázorněno v následujícím příkladu kódu.Tento příklad vyžaduje úrovni dokumentu projekt s listu třídu s názvem Sheet1.
Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)
Globals.Sheet1.CheckSpelling(ignoreUppercase: true);
Například v aplikaci Word
Find.Execute Metoda má mnoho volitelných parametrů.Můžete zadat hodnoty pro některé parametry a přijměte výchozí hodnotu ostatních, jak je znázorněno v následujícím příkladu kódu.
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);
Aplikace Word pomocí volitelné parametry metody ThisDocument třídy v úrovni dokumentu projekty Visual C#
Objektový model aplikace Word obsahuje mnoho metod s volitelnými ref parametry, které přijímají Object hodnoty.Však nelze vynechat volitelné ref parametry metod generované ThisDocument třídy v úrovni dokumentu projekty Visual C# aplikace Word.Visual C# umožňuje vynechat volitelné ref parametry pouze pro metody rozhraní, nikoli tříd.Například následující příklad kódu nezkompiluje, protože je nelze vynechat volitelné ref parametry CheckSpelling metoda ThisDocument třídy.
Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);
Při volání metody ThisDocument třídy, postupujte podle následujících pokynů:
Přijměte výchozí hodnotu volitelného ref parametr, předejte missing k parametru proměnná.missing Proměnné je automaticky definováno v projekty Visual C# Office a je přiřazena hodnota Type.Missing v kódu generovaném projektu.
Chcete-li určit vlastní hodnoty pro volitelný ref parametru deklarovat objekt přiřazena hodnota, kterou chcete zadat a objekt předat parametr.
Následující příklad kódu ukazuje, jak volat CheckSpelling zadáním hodnoty pro metodu ignoreUppercase parametr a přijetí výchozí hodnota pro další parametry.
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);
Pokud chcete psát kód, který vynechá volitelné ref parametry metody v ThisDocument třídy, můžete také volat stejnou metodou na Document objekt vrácený funkcí InnerObject vlastnost a vynechat parametry z metody.To lze provést, protože Document rozhraní, nikoli třídy.
Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Další informace o referenční hodnoty a parametry typu, naleznete v Předávání argumentů podle hodnoty a odkazu (Visual Basic) (pro Visual Basic) a Předávání parametrů (Průvodce programováním v C#).
Viz také
Koncepty
Psaní kódu v řešeních pro systém Office