NamedRange.ApplyNames Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

Microsoft.Office.Tools.Excel.dll

Stosuje nazwy do komórek w kontrolce NamedRange .

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

Parametry

Names

Object

Tablica nazw do zastosowania. Jeśli ten argument zostanie pominięty, wszystkie nazwy w arkuszu są stosowane do zakresu.

IgnoreRelativeAbsolute

Object

true zastąpić odwołania nazwami, niezależnie od typów referencyjnych nazw lub odwołań; false aby zastąpić odwołania bezwzględne tylko nazwami bezwzględnymi, odwołania względne tylko z nazwami względnymi i mieszane odwołania tylko z nazwami mieszanymi. Wartość domyślna to true.

UseRowColumnNames

Object

true aby użyć nazw zakresów wierszy i kolumn zawierających określony zakres, jeśli nie można odnaleźć nazw zakresu; false aby zignorować OmitColumn argumenty i OmitRow . Wartość domyślna to true.

OmitColumn

Object

true aby zastąpić całe odwołanie nazwą zorientowaną na wiersz. Nazwa zorientowana na kolumnę może zostać pominięta tylko wtedy, gdy przywoływana komórka znajduje się w tej samej kolumnie co formuła i znajduje się w zakresie nazwanym w wierszu. Wartość domyślna to true.

OmitRow

Object

true aby zastąpić całe odwołanie nazwą zorientowaną na kolumnę. Nazwa zorientowana na wiersz może zostać pominięta tylko wtedy, gdy przywoływana komórka znajduje się w tym samym wierszu co formuła i znajduje się w zakresie nazwanym w kolumnie. Wartość domyślna to true.

Order

XlApplyNamesOrder

Określa, która nazwa zakresu jest wyświetlana jako pierwsza, gdy odwołanie do komórki jest zastępowane przez nazwę zakresu zorientowanego na wiersz i kolumnę. Może być jedną z następujących XlApplyNamesOrder stałych: xlColumnThenRowxlRowThenColumn

AppendLast

Object

true zastąpić definicje nazw w pliku Names , a także zastąpić definicje zdefiniowanych nazwisk, false aby zastąpić definicje nazw tylko w Names . Wartość domyślna to false.

Zwraca

Object

Przykłady

Poniższy przykład kodu używa metody w ApplyNames celu zastosowania zestawu nazw do kontrolki NamedRange .

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Za pomocą Array funkcji można utworzyć listę nazw argumentu Names .

Jeśli chcesz zastosować nazwy do całego arkusza, użyj polecenia Cells.ApplyNames.

Nie można "nie zastosować" nazw; aby usunąć nazwy, użyj Delete metody .

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.