Class WorksheetNamesCollection
Summary description for NamesCollection.
Implements
Inherited Members
Namespace: Syncfusion.XlsIO.Implementation.Collections
Assembly: Syncfusion.XlsIO.Portable.dll
Syntax
public class WorksheetNamesCollection : CollectionBaseEx<IName>, IList<IName>, ICollection<IName>, IEnumerable<IName>, IParentApplication, ICloneParent, INames, IEnumerable
  Constructors
WorksheetNamesCollection(IApplication, Object)
Creates new empty collection.
Declaration
public WorksheetNamesCollection(IApplication application, object parent)
  Parameters
| Type | Name | Description | 
|---|---|---|
| IApplication | application | Application object for the collection.  | 
      
| System.Object | parent | Parent object for the new collection.  | 
      
Properties
Item[Int32]
Returns a single Name object from a Names collection.
Declaration
public IName this[int index] { get; }
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.Int32 | index | 
Property Value
| Type | 
|---|
| IName | 
Item[String]
Returns a single Name object from a Names collection.
Declaration
public IName this[string name] { get; }
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | name | 
Property Value
| Type | 
|---|
| IName | 
ParentWorksheet
Returns parent worksheet of the collection.
Declaration
public IWorksheet ParentWorksheet { get; }
  Property Value
| Type | 
|---|
| IWorksheet | 
Methods
Add(IName)
Defines a new name.
Declaration
public IName Add(IName name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| IName | name | Name object to add.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Added Name object.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If name argument is NULL.  | 
      
Add(IName, Boolean)
Defines a new name.
Declaration
public IName Add(IName name, bool bAddInGlobalNamesHash)
  Parameters
| Type | Name | Description | 
|---|---|---|
| IName | name | Name object to add.  | 
      
| System.Boolean | bAddInGlobalNamesHash | Indicates is adds in global names hash.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Added Name object.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If name argument is NULL.  | 
      
Add(NameRecord)
Defines a new name.
Declaration
public IName Add(NameRecord name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| NameRecord | name | NameRecord containing info for new Name object.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Name object that was added to the collection.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If specified NameRecord is NULL.  | 
      
Add(NameRecord, Boolean)
Defines a new name.
Declaration
public IName Add(NameRecord name, bool bAddInGlobalNamesHash)
  Parameters
| Type | Name | Description | 
|---|---|---|
| NameRecord | name | NameRecord containing info for new Name object.  | 
      
| System.Boolean | bAddInGlobalNamesHash | Indicates is adds in global names hash.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Name object that was added to the collection.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If specified NameRecord is NULL.  | 
      
Add(String)
Adds new named range to the collection.
Declaration
public IName Add(string name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | name | Name of the new named range.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Newly added named range.  | 
      
Add(String, IRange)
Defines a new name.
Declaration
public IName Add(string name, IRange namedRange)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | name | Name for the new Name object.  | 
      
| IRange | namedRange | Range that will be associated with the Name.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Newly created Name object.  | 
      
AddLocal(IName)
Adds a new name only to this collection (without registering it in the workbook names collection).
Declaration
public IName AddLocal(IName name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| IName | name | Name object to add.  | 
      
Returns
| Type | Description | 
|---|---|
| IName | Added Name object.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If name argument is NULL.  | 
      
AddRange(NameRecord[])
Defines range of new names.
Declaration
public void AddRange(NameRecord[] names)
  Parameters
| Type | Name | Description | 
|---|---|---|
| NameRecord[] | names | Array of NameRecords containing info for new Name objects.  | 
      
Exceptions
| Type | Condition | 
|---|---|
| System.ArgumentNullException | If array of NameRecords is NULL.  | 
      
Clear()
Clear collection.
Declaration
public void Clear()
  Contains(String)
Checks whether collection contains named range.
Declaration
public bool Contains(string name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | name | Name of the named range to search.  | 
      
Returns
| Type | Description | 
|---|---|
| System.Boolean | True if collection contains such named range; otherwise returns False.  | 
      
ConvertFullRowColumnNames(ExcelVersion)
Converts full row or column tokens between versions.
Declaration
public void ConvertFullRowColumnNames(ExcelVersion version)
  Parameters
| Type | Name | Description | 
|---|---|---|
| ExcelVersion | version | Version to convert into.  | 
      
GetOrCreateName(String)
Returns existing or creates new name.
Declaration
public NameImpl GetOrCreateName(string strName)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | strName | Name to create.  | 
      
Returns
| Type | Description | 
|---|---|
| NameImpl | Required name.  | 
      
OnInsertComplete(Int32, IName)
Performs additional processes after inserting a new element into the collection.
Declaration
protected override void OnInsertComplete(int index, IName value)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.Int32 | index | The zero-based index at which to insert value.  | 
      
| IName | value | The new value of the element at the index.  | 
      
Overrides
Remove(String)
Removes Name object from the collection.
Declaration
public void Remove(string name)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.String | name | Name of the object to remove.  | 
      
RemoveAt(Int32)
Removes the element at the specified index from the collection.
Declaration
public void RemoveAt(int index)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.Int32 | index | The zero-based index of the element to remove.  | 
      
Rename(IName, String)
Renames name in Name-to-IName hashtable.
Declaration
public void Rename(IName name, string strOldName)
  Parameters
| Type | Name | Description | 
|---|---|---|
| IName | name | New name implementation.  | 
      
| System.String | strOldName | Old name.  | 
      
SetSheetIndex(Int32)
Sets sheet index.
Declaration
public void SetSheetIndex(int iSheetIndex)
  Parameters
| Type | Name | Description | 
|---|---|---|
| System.Int32 | iSheetIndex | Sheet index to set.  | 
      
Explicit Interface Implementations
INames.Count
Represent the known named ranges count The name in the formula which has no reference is unknown named ranges
Declaration
int INames.Count { get; }
  Returns
| Type | 
|---|
| System.Int32 |