NamedRange.ApplyNames Metode

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Excel

Rakitan:: Microsoft.Office.Tools.Excel.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menerapkan nama ke sel dalam NamedRange kontrol.

public object ApplyNames (object Names, object IgnoreRelativeAbsolute, object UseRowColumnNames, object OmitColumn, object OmitRow, Microsoft.Office.Interop.Excel.XlApplyNamesOrder Order = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, object AppendLast);

abstract member ApplyNames : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlApplyNamesOrder * obj -> obj

Public Function ApplyNames (Optional Names As Object, Optional IgnoreRelativeAbsolute As Object, Optional UseRowColumnNames As Object, Optional OmitColumn As Object, Optional OmitRow As Object, Optional Order As XlApplyNamesOrder = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, Optional AppendLast As Object) As Object

Parameter

Names: Object

Array nama yang akan diterapkan. Jika argumen ini dihilangkan, semua nama pada lembar diterapkan ke rentang.

IgnoreRelativeAbsolute: Object

true untuk mengganti referensi dengan nama, terlepas dari jenis referensi nama atau referensi; false untuk mengganti referensi absolut hanya dengan nama absolut, referensi relatif hanya dengan nama relatif, dan referensi campuran hanya dengan nama campuran. Nilai defaultnya adalah true.

UseRowColumnNames: Object

true untuk menggunakan nama rentang baris dan kolom yang berisi rentang yang ditentukan jika nama untuk rentang tidak dapat ditemukan; false untuk mengabaikan OmitColumn argumen dan OmitRow . Nilai defaultnya adalah true.

OmitColumn: Object

true untuk mengganti seluruh referensi dengan nama berorientasi baris. Nama berorientasi kolom hanya dapat dihilangkan jika sel yang direferensikan berada di kolom yang sama dengan rumus dan berada dalam rentang bernama berorientasi baris. Nilai defaultnya adalah true.

OmitRow: Object

true untuk mengganti seluruh referensi dengan nama berorientasi kolom. Nama berorientasi baris hanya dapat dihilangkan jika sel yang direferensikan berada di baris yang sama dengan rumus dan berada dalam rentang bernama berorientasi kolom. Nilai defaultnya adalah true.

Order: XlApplyNamesOrder

Menentukan nama rentang mana yang dicantumkan terlebih dahulu saat referensi sel digantikan oleh nama rentang berorientasi baris dan berorientasi kolom. Bisa menjadi salah satu konstanta ini XlApplyNamesOrder : xlColumnThenRow xlRowThenColumn

AppendLast: Object

true untuk mengganti definisi nama di Names dan juga mengganti definisi nama belakang yang ditentukan; false untuk mengganti definisi nama Names di saja. Nilai defaultnya adalah false.

Mengembalikan

Object

Contoh

Contoh kode berikut menggunakan ApplyNames metode untuk menerapkan sekumpulan nama ke NamedRange kontrol.

Contoh ini untuk kustomisasi tingkat dokumen.

private void AddNames()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    string[] s = new string[] { "One", "Two", "Three", "Four", "Five" };
    namedRange1.ApplyNames(s, true, true, true, true,
        Excel.XlApplyNamesOrder.xlColumnThenRow, false);
}

Private Sub AddNames()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    Dim s() As String = {"One", "Two", "Three", "Four", "Five"}
    namedRange1.ApplyNames(s, True, True, True, True, _
        Excel.XlApplyNamesOrder.xlColumnThenRow, False)
End Sub

Keterangan

Anda dapat menggunakan Array fungsi untuk membuat daftar nama untuk Names argumen .

Jika Anda ingin menerapkan nama ke seluruh lembar, gunakan Cells.ApplyNames.

Anda tidak dapat nama "tidak terapkan"; untuk menghapus nama, gunakan Delete metode .

Parameter Opsional

Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.

Berlaku untuk

Bagikan melalui