Parametri facoltativi nelle soluzioni Office
Molti dei metodi disponibili nei modelli a oggetti delle applicazioni di Microsoft Office accettano parametri facoltativi. Se si utilizza Visual Basic per sviluppare una soluzione Office in Visual Studio 2010, non è necessario passare un valore per i parametri facoltativi, in quanto per ogni parametro mancante vengono utilizzati automaticamente i valori predefiniti. Nella maggior parte dei casi, è anche possibile omettere i parametri facoltativi nei progetti Visual C#. Nei progetti a livello di documento per Word, non è tuttavia possibile omettere parametri ref facoltativi della classe ThisDocument.
Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Microsoft Office 2010 e Microsoft Office System 2007. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.
Per ulteriori informazioni sull'utilizzo di parametri facoltativi in progetti Visual C# e Visual Basic, vedere Argomenti denominati e facoltativi (Guida per programmatori C#) e Optional Parameters.
Nota
Nelle versioni precedenti di Visual Studio, è necessario passare un valore per ogni parametro facoltativo nei progetti Visual C#. Per praticità, questi progetti includono una variabile globale denominata missing che è possibile passare a un parametro facoltativo quando si desidera utilizzare il valore predefinito del parametro. I progetti Visual C# per Office in Visual Studio 2010 includono ancora la variabile missing, ma in genere non è necessario utilizzarla quando si sviluppano soluzioni Office in Visual Studio 2010, salvo quando si chiamano metodi con i parametri ref facoltativi nella classe ThisDocument nei progetti a livello di documento per Word.
Esempio in Excel
Il metodo Worksheet.CheckSpelling dispone di molti parametri facoltativi. È possibile specificare valori per alcuni parametri e accettare il valore predefinito per altri, come indicato nel seguente esempio di codice. In questo esempio viene richiesto un progetto a livello di documento con una classe del foglio di lavoro denominata Sheet1.
Globals.Sheet1.CheckSpelling(ignoreUppercase:=True)
// In projects that target the .NET Framework 3.5, change "ignoreUppercase" to "IgnoreUppercase"
// in the following line of code.
Globals.Sheet1.CheckSpelling(ignoreUppercase: true);
Esempio in Word
Il metodo Find.Execute dispone di molti parametri facoltativi. È possibile specificare valori per alcuni parametri e accettare il valore predefinito per altri, come indicato nel seguente esempio di codice.
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);
Utilizzo di parametri facoltativi di metodi nella classe ThisDocument in progetti a livello di documento Visual C# per Word
Il modello a oggetti di Word contiene molti metodi con parametri ref facoltativi che accettano valori Object. Nei progetti a livello di documento Visual C# per Word, non è tuttavia possibile omettere parametri ref facoltativi dei metodi della classe ThisDocument generata nel progetto. Visual C# consente di omettere parametri ref facoltativi solo per metodi delle interfacce, non classi. L'esempio di codice seguente non viene compilato perché non è possibile omettere parametri ref facoltativi del metodo CheckSpelling della classe ThisDocument.
Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);
Quando si chiamano metodi della classe ThisDocument, attenersi alle linee guida riportate di seguito:
Per accettare il valore predefinito di un parametro ref facoltativo, passare la variabile missing al parametro. La variabile missing è definita automaticamente nei progetti Office di Visual C# ed è assegnata al valore Type.Missing nel codice di progetto generato.
Per specificare il valore per un parametro ref facoltativo, dichiarare un oggetto assegnato al valore che si desidera specificare, quindi passare l'oggetto al parametro.
Nell'esempio di codice seguente viene dimostrato come chiamare il metodo CheckSpelling specificando un valore per il parametro ignoreUppercase e accettando il valore predefinito per gli altri parametri.
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 si desidera scrivere codice che ometta parametri ref facoltativi di un metodo nella classe ThisDocument, è possibile chiamare alternativamente lo stesso metodo sull'oggetto Microsoft.Office.Interop.Word.Document restituito dalla proprietà InnerObject e omettere i parametri da tale metodo. Tale operazione è possibile perché Microsoft.Office.Interop.Word.Document è un'interfaccia e non una classe.
Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Per ulteriori informazioni sui parametri di tipo valore e riferimento, vedere Passaggio di argomenti per valore e per riferimento (per Visual Basic) e Passaggio di parametri (Guida per programmatori C#).
Vedere anche
Concetti
Scrittura di codice nelle soluzioni Office