NamedRange.ApplyNames Método

Definição

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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

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

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 os nomes do intervalo não puderem ser encontrados; false para ignorar os OmitColumn argumentos 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 a linhas e orientado a colunas. Pode ser uma destas XlApplyNamesOrder constantes: xlColumnThenRowxlRowThenColumn

AppendLast

Object

true para substituir as definições dos nomes em Names e também substituir as definições dos sobrenomes que foram definidos; false para substituir apenas as definições dos nomes 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 à planilha inteira, use Cells.ApplyNames.

Não é possível "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.