Add(String,String,CellReferenceMode) Method

Adds a named reference with a scope of the collection's associated Workbook to the collection.

Syntax

Visual Basic

'Declaration
 
Public Overloads Function Add( _
   ByVal name As String, _
   ByVal formula As String, _
   ByVal cellReferenceMode As CellReferenceMode _
) As NamedReference

C#

public NamedReference Add( 
   string name,
   string formula,
   CellReferenceMode cellReferenceMode
)

Parameters

name

The name to give the named reference.

formula

The formula to give the named reference.

cellReferenceMode

The mode used to interpret cell references in the formula.

Return Value

The named reference which was added to the collection.

Exceptions

Exception	Description
System.ArgumentNullException	name is null or empty.
System.ArgumentException	name is longer than 255 characters.
System.ArgumentException	name is invalid. The name must begin with a letter, underscore (_), or a backslash (\). All other characters in the name must be letters, numbers, periods, underscores (_), or backslashes (\). The name cannot be a an A1 cell reference (1 to 3 letters followed by 1 to 6 numbers). In addition, the name cannot be 'r', 'R', 'c', or 'C' or start with a row or column reference in R1C1 cell reference mode ('R' followed by 1 to 6 numbers or 'C' followed by 1 to 6 numbers).
System.InvalidOperationException	name is used by another named reference which also has a scope of the workbook. Named reference names are compared case-insensitively.
System.ArgumentNullException	formula is null or empty.
System.ArgumentException	formula is not a valid formula. The inner exception will contain the FormulaParseException describing the reason the formula was not valid.
System.ComponentModel.InvalidEnumArgumentException	cellReferenceMode is not defined in the CellReferenceMode enumeration.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2