Condividi tramite


Metodo NamedRange.ApplyNames

Applica nomi alle celle nel controllo NamedRange.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function ApplyNames ( _
    Names As Object, _
    IgnoreRelativeAbsolute As Object, _
    UseRowColumnNames As Object, _
    OmitColumn As Object, _
    OmitRow As Object, _
    Order As XlApplyNamesOrder, _
    AppendLast As Object _
) As Object
Object ApplyNames(
    Object Names,
    Object IgnoreRelativeAbsolute,
    Object UseRowColumnNames,
    Object OmitColumn,
    Object OmitRow,
    XlApplyNamesOrder Order,
    Object AppendLast
)

Parametri

  • Names
    Tipo: System.Object
    Matrice di nomi da applicare.Se questo argomento viene omesso, tutti i nomi nel foglio vengono applicati all'intervallo.
  • IgnoreRelativeAbsolute
    Tipo: System.Object
    true per sostituire i riferimenti con dei nomi, indipendentemente dai tipi di riferimento dei nomi o dei riferimenti; false per sostituire i riferimenti assoluti solo con nomi assoluti, i riferimenti relativi solo con nomi relativi e i riferimenti misti solo con nomi misti.Il valore predefinito è true.
  • UseRowColumnNames
    Tipo: System.Object
    true per utilizzare i nomi di intervalli di righe o di colonne che contengono l'intervallo specificato, se i nomi per l'intervallo non sono reperibili; false per ignorare gli argomenti OmitColumn e OmitRow.Il valore predefinito è true.
  • OmitColumn
    Tipo: System.Object
    true per sostituire l'intero riferimento con il nome orientato alla riga.È possibile omettere il nome orientato alla colonna solo se la cella di riferimento si trova nella stessa colonna della formula ed è compreso in un intervallo con nome orientato alla riga.Il valore predefinito è true.
  • OmitRow
    Tipo: System.Object
    true per sostituire l'intero riferimento con il nome orientato alla colonna.È possibile omettere il nome orientato alla riga solo se la cella di riferimento si trova nella stessa riga della formula ed è compreso in un intervallo con nome orientato alla colonna.Il valore predefinito è true.
  • AppendLast
    Tipo: System.Object
    true per sostituire le definizioni dei nomi in Names e sostituire anche le definizioni degli ultimi nomi definiti; false per sostituire le definizioni solo dei nomi in Names.Il valore predefinito è false.

Valore restituito

Tipo: System.Object

Note

È possibile utilizzare la funzione Array per creare l'elenco di nomi per l'argomento Names.

Se si desidera applicare nomi all'intero foglio, utilizzare Cells.ApplyNames.

Non è possibile annullare l'applicazione di nomi. Per eliminare i nomi, utilizzare il metodo Delete.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo ApplyNames per applicare un set di nomi a un controllo NamedRange.

Questo esempio è valido per una personalizzazione a livello di documento.

    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

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel