NamedRange.ApplyNames(Object, Object, Object, Object, Object, XlApplyNamesOrder, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.