Método NamedRange.ApplyNames

Artigo
08/01/2011

Aplica nomes às células de NamedRange de controle.

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 dos nomes a serem aplicadas.Se esse argumento for omitido, todos os nomes da planilha são aplicados ao intervalo.

IgnoreRelativeAbsolute
Tipo: System.Object
true para substituir referências por nomes, independentemente dos tipos de referência de nomes ou de referências; falsepara substituir referências absolutas somente por nomes absolutos, referências relativas somente por nomes relativos e referências mistas somente por nomes mistos.O valor padrão é true.

UseRowColumnNames
Tipo: System.Object
true Para usar os nomes dos intervalos de linhas e colunas que contêm o intervalo especificado, se os nomes para o intervalo não podem ser encontrados; falsepara ignorar o OmitColumn e OmitRow argumentos.O valor padrão é true.

OmitColumn
Tipo: System.Object
true para substituir toda a referência pelo nome orientado por linha.O nome orientado por coluna pode ser omitido se a célula referida estiver na mesma coluna como a fórmula e dentro de um intervalo nomeado orientado por linha.O valor padrão é true.

OmitRow
Tipo: System.Object
true para substituir toda a referência pelo nome orientado por coluna.O nome orientado por linha pode ser omitido se a célula referida estiver na mesma linha que a fórmula e dentro de um intervalo nomeado orientado por coluna.O valor padrão é true.

Order
Tipo: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Determina qual nome de intervalo é listado primeiro quando uma referência de célula é substituída por um nome de intervalo orientado por linha e orientado por coluna.
Pode ser um desses XlApplyNamesOrder constantes:
xlColumnThenRow
xlRowThenColumn

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

Valor de retorno

Tipo: System.Object

Comentários

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

Se você quiser aplicar nomes à planilha inteira, use Cells.ApplyNames.

Você não pode "Desaplicar" nomes; Para excluir nomes, use o Delete método.

Optional Parameters

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

Exemplos

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

Este exemplo é para uma personalização em nível de 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);
}

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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via