Propriedade WorksheetBase.CircularReference

Artigo
01/09/2014

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

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

public Range CircularReference { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
Um objeto de Range que representa o intervalo que contém a primeira referência circular na folha; nulluma referência nula (Nothing no Visual Basic) se não há nenhuma referência circular na folha.

Comentários

A referência circular deve ser removido antes que o cálculo possa continuar.

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 de se. O exemplo usa a propriedade de CircularReference para relatar se a planilha tem uma referência circular.

Este exemplo destina-se a uma personalização no 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"].Formula = "=B1";
    this.Range["B1"].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(Excel.XlReferenceStyle.xlA1));
    }
}

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

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via