Método NamedRange.ApplyNames
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 for omitido, todos os nomes na folha são aplicados ao intervalo.
- IgnoreRelativeAbsolute
Tipo: System.Object
true para substituir referências com nomes, independentemente de tipos de referência dos nomes de referências; ou false para substituir referências de caminho absoluto somente com 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 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 de object-oriented.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 de object-oriented.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 de object-oriented.O valor padrão é true.
- Order
Tipo: Microsoft.Office.Interop.Excel.XlApplyNamesOrder
Determinar o nome do intervalo está listada primeiro quando uma referência a célula é substituída por um nome de linha e orientado de object-oriented 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 à folha nomes 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 a seguir usa o método de ApplyNames para aplicar um conjunto de nomes a um controle de NamedRange .
Este exemplo é para uma personalização da 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áveis.