NamedRange.ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object) Método

Definição

Aplica nomes às células no controle 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);

Parâmetros

Names
Object

Uma matriz de nomes a serem aplicados. Se esse argumento for omitido, todos os nomes na planilha serão aplicados ao intervalo.

IgnoreRelativeAbsolute
Object

true para substituir referências por nomes, independentemente dos tipos de referência dos nomes ou referências, false para 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
Object

true para usar os nomes dos intervalos de linhas e colunas que contêm o intervalo especificado se nomes para o intervalo não puderem ser encontrados, false para ignorar os argumentos OmitColumn e OmitRow. O valor padrão é true.

OmitColumn
Object

true para substituir toda a referência pelo nome orientado por linha. O nome orientado por coluna poderá ser omitido somente se a célula referenciada estiver na mesma coluna que a fórmula e estiver dentro de um intervalo nomeado orientado por linha. O valor padrão é true.

OmitRow
Object

true para substituir toda a referência pelo nome orientado por coluna. O nome orientado por linha poderá ser omitido somente se a célula referenciada estiver na mesma linha que a fórmula e estiver dentro de um intervalo nomeado orientado por coluna. O valor padrão é true.

Order
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 uma dessas constantes XlApplyNamesOrder: xlColumnThenRowxlRowThenColumn

AppendLast
Object

true para substituir as definições dos nomes em Names e também substituir as definições dos últimos nomes que foram definidos, false para substituir as definições dos nomes apenas em Names. O valor padrão é false.

Retornos

Object

Exemplos

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

Este exemplo destina-se a uma personalização no nível de 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

Comentários

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

Se você quiser aplicar nomes a toda a planilha, use Cells.ApplyNames .

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

Parâmetros opcionais

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

Aplica-se a