Volitelné parametry v Office Solutions
Mnoho metod objektových modelů aplikace Microsoft Office přijmout volitelné parametry.Pokud používáte Visual Basic k řešení sady Office v Visual Studio 2012, není nutné předat hodnoty pro volitelné parametry, protože jsou automaticky použity výchozí hodnoty pro každý parametr chybí.Ve většině případů můžete vynechat volitelné parametry v jazyce Visual C# projekty. Však nelze vynechat volitelné ref parametry ThisDocument třídy v projektech úrovni dokumentu aplikace Word.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v systému Office 2013 a Office 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.
Další informace o práci s projekty Visual C# a Visual Basic volitelné parametry viz Pojmenované a volitelné argumenty (Příručka programování 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 Visual C# projekty.Pro pohodlí tyto projekty obsahují globální proměnnou s názvem missing , lze předat volitelný parametr v případě, že chcete použít výchozí hodnotu parametru.Projekty Visual C# pro sadu Office v Visual Studio 2012 stále patří missing proměnné, ale obvykle není nutné používat při vývoji řešení Office v Visual Studio 2012, s výjimkou při volání metody s volitelnou ref parametry v ThisDocument třídy v projekty na úrovni dokumentu aplikace Word.
Například v aplikaci Excel
Worksheet.CheckSpelling Metoda má mnoho volitelných parametrů.Můžete zadat hodnoty pro některé parametry a přijmout výchozí hodnotu ostatních, jak je znázorněno v následujícím příkladu kódu.Tento příklad vyžaduje úroveň dokumentů 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řijmout 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);
Pomocí volitelné parametry metody třídy ThisDocument v projekty Visual C# úrovni dokumentu aplikace Word
Model objektu aplikace Word obsahuje mnoho metod s volitelnou ref parametry, které přijímají Object hodnoty.Však nelze vynechat volitelné ref parametry metod generované ThisDocument třídy Visual C# projekty úrovni dokumentu aplikace Word.Visual C# umožňuje vynechat volitelné ref parametry pouze pro metody rozhraní, nikoli třídy.Například následující příklad kódu nezkompiluje, protože 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 těchto pokynů:
Přijměte výchozí hodnotu volitelného ref parametr, předejte missing parametru proměnná.missing Proměnná je definována automaticky v projekty Visual C# Office a je přiřazena hodnota Type.Missing v kódu generovaném projektu.
Chcete-li zadat vlastní hodnotu pro volitelný ref deklarovat objekt, který je přiřazena hodnota, kterou chcete zadat parametr a objekt předat parametr.
Následující příklad kódu ukazuje způsob volání CheckSpelling zadáním hodnoty pro metodu ignoreUppercase parametr a přijetí výchozí hodnota pro jiné 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ává volitelné ref parametry metody v ThisDocument třídy, můžete také volat stejnou metodou na Microsoft.Office.Interop.Word.Document objektu vráceného InnerObject vlastnosti a parametry z metody vynechat.To lze provést, protože Microsoft.Office.Interop.Word.Document je rozhraní než třídy.
Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Další informace o referenční hodnoty a parametry typu viz Předávání argumentů hodnotou a odkaz (Visual Basic) (pro Visual Basic) a Předávání parametrů (Příručka programování C#).