NamedRange.ApplyNames Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Applica nomi alle celle nel controllo 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

Parametri

Names: Object

Matrice di nomi da applicare. Se questo argomento viene omesso, tutti i nomi nel foglio vengono applicati all'intervallo.

IgnoreRelativeAbsolute: 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: Object

true per utilizzare i nomi degli intervalli di righe e colonne che contengono l'intervallo specificato se non è possibile trovare nomi per l'intervallo; false per ignorare gli OmitColumn argomenti e OmitRow . Il valore predefinito è true.

OmitColumn: 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: 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: XlApplyNamesOrder

Determina il nome dell'intervallo elencato per primo quando un riferimento di cella viene sostituito da un nome di intervallo orientato alle righe e orientato alle colonne. Può essere una delle XlApplyNamesOrder seguenti costanti: xlColumnThenRow xlRowThenColumn

AppendLast: Object

true per sostituire le definizioni dei nomi in Names e sostituire anche le definizioni dei cognome definiti; false per sostituire le definizioni dei nomi solo in Names . Il valore predefinito è false.

Restituisce

Object

Esempio

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

Questo esempio è relativo a una personalizzazione a livello di documento.

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

Commenti

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

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

Non è possibile "annullare" i nomi; per eliminare i nomi, usare il Delete metodo .

Parametri facoltativi

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

Si applica a

Condividi tramite