Método NamedRange.GoalSeek

Artigo
08/01/2011

Calcula os valores necessários para atingir uma meta específica.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function GoalSeek ( _
    Goal As Object, _
    ChangingCell As Range _
) As Boolean

bool GoalSeek(
    Object Goal,
    Range ChangingCell
)

Parâmetros

Goal
Tipo: System.Object
O valor que você deseja que sejam retornados nesta célula.

ChangingCell
Tipo: Microsoft.Office.Interop.Excel.Range
Especifica qual célula deve ser alterada para atingir o valor de destino.

Valor de retorno

Tipo: System.Boolean
true Se a meta for atingida bem-sucedida; Caso contrário, false.

Comentários

Se o objetivo é uma quantidade retornada por uma fórmula, será calculado um valor que, quando fornecido à sua fórmula, faz com que a fórmula retornar o número desejado.

Exemplos

O exemplo de código a seguir define uma fórmula em um NamedRange controle e, em seguida, usa o GoalSeek método para determinar qual valor de X na fórmula para retornar o valor 15. O exemplo coloca a resposta na célula B1.

Este exemplo é para uma personalização em nível de documento.

    Private Sub FindGoal()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        Me.Range("B1").Name = "X"
        namedRange1.Formula = "=(X^3)+(3*X^2)+6"
        namedRange1.GoalSeek(15, Me.Range("B1"))
    End Sub

private void FindGoal()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    this.Range["B1", missing].Name = "X";
    namedRange1.Formula = "=(X^3)+(3*X^2)+6";
    namedRange1.GoalSeek(15, this.Range["B1", missing]);
}

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.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via