Condividi tramite

Metodo ControlCollection.AddNamedRange (System 2007)

  • Articolo

Aggiornamento: novembre 2007

Aggiunge un nuovo controllo NamedRange al foglio di lavoro in corrispondenza dell'intervallo specificato.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Sintassi

Public Function AddNamedRange ( _
    range As Range, _
    name As String _
) As NamedRange

Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As NamedRange

returnValue = instance.AddNamedRange(range, _
    name)

public NamedRange AddNamedRange(
    Range range,
    string name
)

Parametri

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.NamedRange

Controllo NamedRange aggiunto all'istanza di ControlCollection.

Eccezioni

Eccezione Condizione
ArgumentNullException

L'argomento name o range è nullriferimento null (Nothing in Visual Basic) oppure l'argomento name ha lunghezza zero.
ControlNameAlreadyExistsException

Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.
InvalidRangeException

L'intervallo specificato non è valido. Impossibile utilizzare gli intervalli di più aree. L'intervallo deve trovarsi nello stesso foglio di lavoro dell'istanza di ControlCollection.

Note

Il metodo AddNamedRange consente di aggiungere controlli NamedRange alla fine dell'oggetto ControlCollection. Per rimuovere un controllo NamedRange aggiunto in precedenza a livello di codice, utilizzare il metodo Remove().

Esempi

Nell'esempio di codice riportato di seguito viene aggiunto un controllo NamedRange alla cella A1, quindi viene impostato il valore dell'intervallo denominato su 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", missing],
        "namedRange1");
    namedRange1.Value2 = "100%";
}

Autorizzazioni

Vedere anche

Riferimenti

ControlCollection Classe

Membri ControlCollection

Spazio dei nomi Microsoft.Office.Tools.Excel