Paramètres facultatifs dans les solutions Office

De nombreuses méthodes des modèles objet fournis dans les applications Microsoft Office acceptent les paramètres optionnels. Si vous utilisez Visual Basic pour développer une solution Office dans Visual Studio, vous n'avez pas besoin de passer de valeur pour les paramètres optionnels, car les valeurs par défaut sont automatiquement utilisées pour les paramètres manquants. Dans la plupart des cas, vous pouvez également omettre les paramètres optionnels dans les projets Visual C#. Toutefois, vous ne pouvez pas omettre les paramètres ref facultatifs de la ThisDocument classe dans les projets Word au niveau du document.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux - projets de niveau document et aux projets de compléments VSTO - . Consultez fonctionnalités disponibles par type d’application et de projet Office.

Pour plus d’informations sur l’utilisation des paramètres optionnels dans les projets Visual C# et Visual Basic, consultez arguments nommés et facultatifs (Guide de programmation C#) et paramètres facultatifs (Visual Basic).

Notes

Dans les versions antérieures de Visual Studio, vous devez passer une valeur pour chaque paramètre optionnel défini dans les projets Visual C#. Pour des raisons pratiques, ces projets incluent une variable globale nommée missing que vous pouvez passer à un paramètre optionnel quand vous voulez utiliser la valeur par défaut du paramètre. Les projets Visual C# pour Office dans Visual Studio incluent toujours la missing variable, mais vous n’avez généralement pas besoin de l’utiliser lorsque vous développez des solutions Office dans Visual Studio 2013 , sauf lorsque vous appelez des méthodes avec des paramètres ref facultatifs dans la ThisDocument classe dans des projets au niveau du document pour Word.

Exemple dans Excel

La méthode CheckSpelling possède de nombreux paramètres optionnels. Vous pouvez spécifier des valeurs pour certains paramètres et accepter la valeur par défaut pour d'autres, comme indiqué dans l'exemple de code suivant. Cet exemple utilise un projet de niveau document avec une classe de feuille de calcul nommée Sheet1.


Globals.Sheet1.CheckSpelling(ignoreUppercase: true);
Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)

Exemple dans Word

La méthode Execute possède de nombreux paramètres optionnels. Vous pouvez spécifier des valeurs pour certains paramètres et accepter la valeur par défaut pour d'autres, comme indiqué dans l'exemple de code suivant.

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

Utiliser des paramètres facultatifs de méthodes dans la classe ThisDocument dans les projets de niveau document Visual C# pour Word

Le modèle objet Word contient de nombreuses méthodes avec des paramètres ref facultatifs qui acceptent des Object valeurs. Toutefois, vous ne pouvez pas omettre les paramètres ref facultatifs des méthodes de la ThisDocument classe générée dans les projets de niveau document Visual C# pour Word. Visual C# vous permet d’omettre les paramètres ref facultatifs uniquement pour les méthodes d’interface, et non pour les classes. Par exemple, l’exemple de code suivant ne se compile pas, car vous ne pouvez pas omettre les paramètres ref facultatifs de la CheckSpelling méthode de la ThisDocument classe.

Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);

Quand vous appelez des méthodes de la classe ThisDocument, suivez ces consignes :

  • Pour accepter la valeur par défaut d’un paramètre ref facultatif, transmettez la missing variable au paramètre. La variable missing est automatiquement définie dans les projets Office Visual C# et est assignée à la valeur Missing dans le code de projet généré.

  • Pour spécifier votre propre valeur pour un paramètre ref facultatif, déclarez un objet qui est assigné à la valeur que vous souhaitez spécifier, puis transmettez l’objet au paramètre.

    L’exemple de code suivant montre comment appeler la CheckSpelling méthode en spécifiant une valeur pour le paramètre IgnoreUppercase et en acceptant la valeur par défaut pour les autres paramètres.

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

    Si vous souhaitez écrire du code qui omet les paramètres ref facultatifs d’une méthode dans la ThisDocument classe, vous pouvez également appeler la même méthode sur l' Document objet retourné par la InnerObject propriété et omettre les paramètres de cette méthode. Vous pouvez faire cela dans la mesure où Document est une interface, pas une classe.

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

    Pour plus d’informations sur les paramètres de type valeur et référence, consultez passer des arguments par valeur et par référence (Visual Basic) (pour Visual Basic) et paramètres Pass (guide de programmation# C ).

Voir aussi