Método NamedRange.ApplyNames

Artigo
01/09/2014

Aplica nomes para as células no controle de NamedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
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
)

Parâmetros

Names
Tipo: System.Object
Uma matriz de nomes a ser aplicados.Se esse argumento é omitido, todos os nomes na folha são aplicados ao intervalo.

IgnoreRelativeAbsolute
Tipo: System.Object
true para substituir referências com nomes, independentemente dos tipos de referência dos nomes de referências; ou false para substituir referências de caminho absoluto somente com os nomes absolutos, referências de relativo somente com nomes relacionados, e referências misturadas somente com nomes mistos.O valor padrão é true.

UseRowColumnNames
Tipo: System.Object
true para usar os nomes dos intervalos de linha e coluna que contém o intervalo especificado se os nomes para o intervalo não podem ser achados; false para ignorar os argumentos de OmitColumn e de OmitRow .O valor padrão é true.

OmitColumn
Tipo: System.Object
true para substituir a referência inteira com o nome do.O nome de object-oriented pode ser omitido somente se a célula é referenciada na mesma coluna que a fórmula e está dentro de um intervalo nomeado orientado a linha.O valor padrão é true.

OmitRow
Tipo: System.Object
true para substituir a referência inteira com o nome do.O nome de object-oriented pode ser omitido somente se a célula é referenciada na mesma linha que a fórmula e está dentro de um intervalo nomeado do.O valor padrão é true.

Order
Tipo: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Determina que nome do intervalo está listada primeiro quando uma referência a célula é substituída por um nome de linha e orientado do intervalo.
Pode ser uma dessas constantes de XlApplyNamesOrder :
xlColumnThenRow
xlRowThenColumn

AppendLast
Tipo: System.Object
true para substituir as definições de nomes em Names e também para substituir as definições dos sobrenomes que foram definidos; false para substituir as definições de nomes em Names somente.O valor padrão é false.

Valor de retorno

Tipo: System.Object

Comentários

Você pode usar a função de Array para criar a lista de nomes para o argumento de Names .

Se você deseja aplicar nomes à folha inteira, use Cells.ApplyNames.

Você não pode unapply “;” nomes para excluir nomes, use o método de Delete .

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código usa o método de ApplyNames para aplicar um conjunto de nomes a um controle de NamedRange .

Este exemplo é para uma personalização de um documento nível.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via