Método ControlCollection.AddNamedRange

Artigo
01/09/2014

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 do nome ou do intervalo é nulluma referência nula (Nothing no Visual Basic), ou o argumento do nome 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 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ável.

Consulte também

Referência

ControlCollection Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via