Propriedade WorksheetBase.CircularReference

Artigo
08/01/2011

Obtém um Range o objeto que representa o intervalo contendo a primeira referência circular na planilha, ou obtém nulluma referência nula (Nothing no Visual Basic) se não houver nenhuma referência circular na planilha.

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

Sintaxe

'Declaração
Public ReadOnly Property CircularReference As Range
    Get

public Range CircularReference { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
A Range objeto que representa o intervalo que contém a primeira referência circular na planilha; nulluma referência nula (Nothing no Visual Basic)Se não houver nenhuma referência circular na planilha.

Comentários

A referência circular deve ser removida antes de proceder o cálculo.

Exemplos

O exemplo de código a seguir cria uma referência circular, definindo as fórmulas das células A1 e B1 para resolver o valor do outro. O exemplo usa o CircularReference propriedade para informar se a planilha tem uma referência circular.

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

Private Sub HasCircularReference()
    Me.Range("A1").Formula = "=B1"
    Me.Range("B1").Formula = "=A1"

    If Me.CircularReference Is Nothing Then
        MsgBox("This worksheet has no circular references")
    Else
        MsgBox("The worksheet has a circular reference at: " & _
            Me.CircularReference.Address( _
            ReferenceStyle:=Excel.XlReferenceStyle.xlA1))
    End If
End Sub

private void HasCircularReference()
{
    this.Range["A1", missing].Formula = "=B1";
    this.Range["B1", missing].Formula = "=A1";

    if (this.CircularReference == null)
    {
        MessageBox.Show("This worksheet has no circular references");
    }
    else
    {
        MessageBox.Show("The worksheet has a circular reference at: " +
            this.CircularReference.get_Address(missing, missing,
            Excel.XlReferenceStyle.xlA1, missing, 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

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via