Parameter opsional dalam solusi Office
Banyak metode dalam model objek Microsoft aplikasi Office lications menerima parameter opsional. Jika Anda menggunakan Visual Basic untuk mengembangkan solusi Office di Visual Studio, Anda tidak perlu meneruskan nilai untuk parameter opsional karena nilai default secara otomatis digunakan untuk setiap parameter yang hilang. Dalam kebanyakan kasus, Anda juga dapat menghilangkan parameter opsional dalam proyek Visual C#. Namun, Anda tidak dapat menghilangkan parameter ThisDocument
ref opsional kelas dalam proyek Word tingkat dokumen.
Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO. Lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.
Untuk informasi selengkapnya tentang bekerja dengan parameter opsional dalam proyek Visual C# dan Visual Basic, lihat Argumen bernama dan opsional (panduan pemrograman C#) dan Parameter opsional (Visual Basic).
Catatan
Di versi Visual Studio yang lebih lama, Anda harus meneruskan nilai untuk setiap parameter opsional dalam proyek Visual C#. Untuk kenyamanan, proyek-proyek ini menyertakan variabel global bernama missing
yang dapat Anda teruskan ke parameter opsional saat Anda ingin menggunakan nilai default parameter. Proyek Visual C# untuk Office di Visual Studio masih menyertakan missing
variabel, tetapi Biasanya Anda tidak perlu menggunakannya saat mengembangkan solusi Office di Visual Studio 2013, kecuali saat Anda memanggil metode dengan parameter ref opsional di ThisDocument
kelas dalam proyek tingkat dokumen untuk Word.
Contoh di Excel
Metode ini CheckSpelling memiliki banyak parameter opsional. Anda dapat menentukan nilai untuk beberapa parameter dan menerima nilai default orang lain seperti yang ditunjukkan dalam contoh kode berikut. Contoh ini memerlukan proyek tingkat dokumen dengan kelas lembar kerja bernama Sheet1
.
Contoh di Word
Metode ini Execute memiliki banyak parameter opsional. Anda dapat menentukan nilai untuk beberapa parameter dan menerima nilai default orang lain seperti yang ditunjukkan dalam contoh kode berikut.
Word.Range documentRange = this.Application.ActiveDocument.Content;
documentRange.Find.ClearFormatting();
documentRange.Find.Execute(FindText: "blue", ReplaceWith: "red", Replace: Word.WdReplace.wdReplaceAll);
Gunakan parameter metode opsional di kelas ThisDocument di proyek tingkat dokumen Visual C# untuk Word
Model objek Word berisi banyak metode dengan parameter ref opsional yang menerima Object nilai. Namun, Anda tidak dapat menghilangkan parameter ref opsional metode kelas yang dihasilkan ThisDocument
di proyek tingkat dokumen Visual C# untuk Word. Visual C# memungkinkan Anda menghilangkan parameter ref opsional hanya untuk metode antarmuka, bukan kelas. Misalnya, contoh kode berikut tidak dikompilasi, karena Anda tidak dapat menghilangkan parameter ref opsional dari CheckSpelling ThisDocument
metode kelas.
Globals.ThisDocument.CheckSpelling(ignoreUppercase: true);
Saat Anda memanggil metode ThisDocument
kelas, ikuti panduan berikut:
Untuk menerima nilai default parameter ref opsional, teruskan
missing
variabel ke parameter . Variabelmissing
secara otomatis ditentukan dalam proyek Visual C# Office dan ditetapkan ke nilai Missing dalam kode proyek yang dihasilkan.Untuk menentukan nilai Anda sendiri untuk parameter ref opsional, deklarasikan objek yang ditetapkan ke nilai yang ingin Anda tentukan, lalu teruskan objek ke parameter .
Contoh kode berikut menunjukkan cara memanggil CheckSpelling metode dengan menentukan nilai untuk parameter ignoreUppercase dan menerima nilai default untuk parameter lain.
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);
Jika Anda ingin menulis kode yang menghilangkan parameter ref opsional dari metode di
ThisDocument
kelas , Anda dapat memanggil metode yang sama pada Document objek yang dikembalikan oleh InnerObject properti, dan menghilangkan parameter dari metode tersebut. Anda dapat melakukan ini karena Document merupakan antarmuka, bukan kelas.Globals.ThisDocument.InnerObject.CheckSpelling(IgnoreUppercase: true);
Untuk informasi selengkapnya tentang parameter jenis nilai dan referensi, lihat Meneruskan argumen menurut nilai dan berdasarkan referensi (Visual Basic) (untuk parameter Visual Basic) dan Pass (panduan pemrograman C#).