Método ControlCollection.AddNamedRange
Adiciona um novo controle de NamedRange a planilha no intervalo especificado.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Sintaxe
'Declaração
Function AddNamedRange ( _
range As Range, _
name As String _
) As NamedRange
NamedRange AddNamedRange(
Range range,
string name
)
Parâmetros
- range
Tipo: Microsoft.Office.Interop.Excel.Range
Range que fornece os limites do controle.
- name
Tipo: System.String
O nome do controle que pode ser usado para indexar o controle na instância de ControlCollection .
Valor de retorno
Tipo: Microsoft.Office.Tools.Excel.NamedRange
O controle de NamedRange que foi adicionado à instância de ControlCollection .
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | O argumento de nome ou do intervalo é nulluma referência nula (Nothing no Visual Basic), ou o nome do argumento tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na instância de ControlCollection . |
InvalidRangeException | O intervalo que foi especificado não é válido.Os intervalos de várias área não podem ser usados.O intervalo deve estar na mesma planilha que a instância de ControlCollection . |
Comentários
O método de AddNamedRange permite que você adicione controles de NamedRange ao final de ControlCollection.Para remover NamedRange controle que foi adicionado anteriormente por meio de programação, usando o método de Remove .
Exemplos
O exemplo de código a seguir adiciona um controle de NamedRange para a célula A1, e defina o valor do intervalo nomeado como 100%.
Private Sub ExcelAddNamedRange()
Dim NamedRange1 As Microsoft.Office.Tools. _
Excel.NamedRange = Me.Controls.AddNamedRange( _
Me.Range("A1"), "NamedRange1")
NamedRange1.Value2 = "100%"
End Sub
private void ExcelAddNamedRange()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1"],
"namedRange1");
namedRange1.Value2 = "100%";
}
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.