Noções básicas sobre parâmetros opcionais in Office Solutions
Muitos dos métodos nos modelos de objeto dos aplicativos do Microsoft Office aceitar parâmetros opcionais.Parâmetros opcionais são opcionais apenas quando a você chamar um método usando o Visual Basic.Quando você usa C# para programar em um aplicativo do Microsoft Office, você deve passar um valor para Tudo parâmetros.
Parâmetro opcional Differences no Visual Basic e Visual C#
Se você usar o Visual Basic para programar em um aplicativo do Microsoft Office, você não precisará passar um valor para parâmetros opcionais porque os valores padrão são usados automaticamente para cada parâmetro ausente.No entanto, os parâmetros opcionais não têm suporte no C#, portanto você deve passar um valor para o método para cada parâmetro.
Projetos de Ferramentas do Visual Studio para o Office Incluir uma variável global nomeado missing que é atribuído ao valor Type.Missing no código gerado.Você pode passar essa variável global para assumir o valor padrão de cada parâmetro opcional que aceita um tipo de referência, como Object.Parâmetros opcionais que aceita um tipo de valor, você deve passar o valor padrão real.Para obter mais informações, consulte passar tipos de valor para parâmetros opcionais no Visual C#.
Exemplo no Excel
O método Worksheet.CheckSpelling usa os seguintes parâmetros opcionais que aceitam os tipos de referência:
CustomDictionary.Indica se deseja usar um dicionário Personalizar se a palavra não for encontrada no dicionário principal.
IgnoreUppercase.Indica se devem ser ignorar maiúsculas.
AlwaysSuggest.Indica se deve ser que o Excel Exibir uma lista de sugeridas grafias alternativas quando uma ortografia incorreta for encontrada.
SpellLang.Indica o idioma do dicionário sendo usado.
Você pode aceitar o valor padrão dos parâmetros conforme o seguinte exemplo de código.
Globals.Sheet1.CheckSpelling()
Globals.Sheet1.CheckSpelling(missing, missing, missing, missing);
Exemplo no Word
Chamando métodos do Microsoft Office Word de C#, em geral, é mais complexa do que chamar métodos para outros aplicativos do Office, porque você deve passar todos os parâmetros opcionais por referência.
Por exemplo, o método Document.CheckSpelling usa os seguintes parâmetros opcionais para spellchecking um documento do Word:
CustomDictionary.O Nome do Arquivo do dicionário Personalizar.
IgnoreUppercase.Indica se devem ser ignorar maiúsculas.
AlwaysSuggest.Indica se para que o Word exibir uma lista de sugeridas grafias alternativas quando uma ortografia incorreta é encontrado
CustomDictionary2 – CustomDictionary10.Os nomes de arquivo dos dicionários Personalizars adicionais.Você pode especificar até nove dicionários adicionais.
Você pode aceitar o valor padrão dos parâmetros conforme o seguinte exemplo de código.
Me.CheckSpelling()
this.CheckSpelling(
ref missing, ref missing, ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing, ref missing, ref missing);
Tipos de valor de passagem para parâmetros opcionais no Visual C#
No Visual C#, você só pode passar a variável global missing para parâmetros opcionais que aceitam os tipos de referência.Para os parâmetros opcionais que aceitam os tipos de valor, você deve determinar o valor padrão real e passar que em vez disso.
Por exemplo, o método Sort da classe NamedRange aceita um grande número de valores enumerados como parâmetros, como Microsoft.Office.Interop.Excel.XlSortOrder.Como esse é um tipo de valor, você deve especificar um dos valores XlSortOrder em vez de passar a variável global missing.
Para obter mais informações sobre parâmetros de tipo de valor e referência, consulte Argumento passar por valor e por referência (para o Visual Basic) e Passando parâmetros (Guia de programação C#).
Consulte também
Conceitos
Desenvolvendo soluções do Office
Gerenciado código e Programação do Office com o Visual Studio