Método ControlCollection.AddChart (Range, String)

Artigo
08/01/2011

Adiciona um novo Chart o controle para 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 AddChart ( _
    range As Range, _
    name As String _
) As Chart

Chart AddChart(
    Range range,
    string name
)

Parâmetros

range
Tipo: Microsoft.Office.Interop.Excel.Range
A Range que fornece os limites para o controle.

name
Tipo: System.String
O nome do controle que pode ser usado para indexar o controle de ControlCollection instância.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Chart
O Chart controle foi adicionado para o ControlCollection instância.

Exceções

Exceção	Condição
ArgumentNullException	O argumento do nome ou o intervalo é nulluma referência nula (Nothing no Visual Basic), ou o argumento nome tem comprimento zero.
ControlNameAlreadyExistsException	Um controle com o mesmo nome já está na ControlCollection instância.
InvalidRangeException	O intervalo especificado não é válido. Intervalos de múltiplas áreas não podem ser usados. O intervalo deve estar na mesma planilha como o ControlCollection instância.

Comentários

O AddChart método permite que você adicione Chart controles para o fim da ControlCollection. Para remover um Chart o controle que foi previamente adicionado programaticamente, use o Remove método.

Exemplos

O exemplo de código a seguir insere o número 16 para células E1 por meio de E3 e o número de 24 a células F1 por meio de F3. O código cria um Chart controle às células A1 por meio de C8 e passa as células E1 por meio de F3 para o SetSourceData método para preencher o gráfico com dados.

Private Sub ExcelAddRangeChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
        = Me.Controls.AddChart(Me.Range("A1", "C8"), _
        "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F5"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub

private void ExcelAddRangeChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");

    chart1.SetSourceData(this.Range["E1", "F5"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

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.