Metodo NamedRange.ApplyNames

Articolo
08/11/2011

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.

Order
Tipo: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Determina il nome di intervallo elencato per primo quando un riferimento di cella viene sostituito da un nome di intervallo orientato alla riga e alla colonna.
Può essere una delle costanti di XlApplyNamesOrder.
xlColumnThenRow
xlRowThenColumn

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

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via