Parâmetros opcionais em soluções do Office

Muitos dos métodos nos modelos de objeto de aplicativos do Microsoft Office aceitam parâmetros opcionais.Se você usar Visual Basic para desenvolver uma solução do Office em Visual Studio 2012, você não precisa passar um valor para parâmetros opcionais porque os valores padrão são usados automaticamente para cada parâmetro ausente.Em a maioria dos casos, você também pode omitir os parâmetros opcionais em projetos visual C#. Em o entanto, você não pode omitir os parâmetros opcionais de ref da classe de ThisDocument em projetos de um documento do word nível.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para obter mais informações sobre como trabalhar com parâmetros opcionais em projetos Visual C# e visual Basic, consulte Argumentos nomeados e opcionais (guia de programação do C#) e Parâmetros opcionais (Visual Basic).

ObservaçãoObservação

Em versões anteriores do Visual Studio, você deve passar um valor para cada parâmetro opcional em projetos visual C#.Para sua conveniência, esses projetos incluem uma variável global chamado missing que você pode passar um parâmetro opcional quando você deseja usar o valor padrão do parâmetro.Os projetos visual C# para o Office em Visual Studio 2012 ainda incluem a variável de missing , mas você normalmente não precisará usá-lo quando você desenvolve soluções do Office em Visual Studio 2012, exceto quando você chamar métodos com parâmetros opcionais de ref na classe de ThisDocument em um documento nível se projetos para palavra.

Exemplo do excel

O método de Worksheet.CheckSpelling tem vários parâmetros opcionais.Você pode especificar valores para alguns parâmetros e aceite o valor padrão de outro conforme mostrado no exemplo de código a seguir.Esse exemplo requer um projeto da nível de classe com uma planilha chamada Sheet1.

Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)

Globals.Sheet1.CheckSpelling(ignoreUppercase: true);

Exemplo no word

O método de Find.Execute tem vários parâmetros opcionais.Você pode especificar valores para alguns parâmetros e aceite o valor padrão de outro conforme mostrado no exemplo de código a seguir.

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

Usando parâmetros opcionais dos métodos na classe ThisDocument em projetos visual C# Nível de um documento do word

O modelo de objeto do word contém vários métodos com parâmetros opcionais de ref que aceitam valores de Object .Em o entanto, você não pode omitir os parâmetros opcionais de ref dos métodos da classe gerada de ThisDocument em projetos visual da nível de C# para palavra.Visual C# permite que você omitir os parâmetros opcionais de ref somente para métodos de interfaces, não classes.Por exemplo, o exemplo de código não compilar, porque você não pode omitir os parâmetros opcionais de ref do método de CheckSpelling da classe de ThisDocument .

Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);

Quando você chama os métodos de ThisDocument classe, siga estas diretrizes:

  • Para aceitar o valor padrão de um parâmetro opcional de ref , passe a variável de missing para o parâmetro.A variável de missing automaticamente é definido em projetos visual C# Office e atribuído ao valor Type.Missing no código de projeto gerado.

  • Para especificar seu próprio valor para um parâmetro opcional de ref , declare um objeto que é atribuído ao valor que você deseja especificar, e passe o objeto para o parâmetro.

O exemplo de código a seguir demonstra como chamar o método de CheckSpelling especificando um valor para o parâmetro de ignoreUppercase e aceitar o valor padrão para os outros parâmetros.

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

Se você quiser escrever código que omite parâmetros opcionais de ref de um método na classe de ThisDocument como alternativa, você pode chamar o mesmo método no objeto de Microsoft.Office.Interop.Word.Document retornado pela propriedade de InnerObject , e omitir os parâmetros do método.Você pode fazer isso porque Microsoft.Office.Interop.Word.Document é uma interface, e não uma classe.

Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);

Para obter mais informações sobre parâmetros de tipo de valor e por referência, consulte Passando argumentos por valor e por referência (Visual Basic) (Visual Basic) e Passando parâmetros (guia de programação do C#).

Consulte também

Conceitos

Escrevendo código em soluções do Office

Outros recursos

Desenvolvendo soluções do Office