XL.Sheet.GetNamedRange
----------------------

Gets the named range coordianates by name.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [XL](component_XL.md) | [3.5](newinversion35.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "XL.Sheet.GetNamedRange"; BookRef; SheetIndex; Name; Selector { ; ScopeID } ) 

**MBS**( **"XL.Sheet.GetNamedRange";** /\* Gets the named range coordianates by name. \*/  
**$BookRef**; /\* The reference number for the workbook.e.g. $ref \*/   
**$SheetIndex**; /\* The index of the sheet. This number ranges from 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-1.e.g. 0 \*/   
**$Name**; /\* The name of the named range.e.g. "test" \*/   
**$Selector**; /\* Which value to return: rowFirst, rowLast, colFirst, colLast, name.e.g. "rowFirst" \*/   
**$ScopeID**) /\* Optional; The scope ID to use for search.  
Can be -2 for undefined, -1 for workbook or positive number for other IDs.  
Default is undefined.e.g. -1 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| BookRef | The reference number for the workbook. | $ref |  |
| SheetIndex | The index of the sheet. This number ranges from 0 to [XL.Book.SheetCount](XLBookSheetCount.md)-1. | 0 |  |
| Name | The name of the named range. | "test" |  |
| Selector | Which value to return: rowFirst, rowLast, colFirst, colLast, name. | "rowFirst" |  |
| ScopeID | The scope ID to use for search.   Can be -2 for undefined, -1 for workbook or positive number for other IDs.   Default is undefined. | -1 | Optional |

### Result

Returns value or error.

### Description

Gets the named range coordianates by name.   
### See also

- [XL.Book.SheetCount](XLBookSheetCount.md)
- [XL.Sheet.DeleteNamedRange](XLSheetDeleteNamedRange.md)
- [XL.Sheet.NamedRange](XLSheetNamedRange.md)
- [XL.Sheet.SetNamedRange](XLSheetSetNamedRange.md)

### Release notes

- **Version 8.2**
    - Added scope ID parameter for [XL.Sheet.GetNamedRange](http://www.mbsplugins.eu/XLSheetGetNamedRange.shtml) and [XL.Sheet.NamedRange](http://www.mbsplugins.eu/XLSheetNamedRange.shtml).

### Blog Entries

- [MBS FileMaker Plugin, version 8.2pr1](https://www.mbsplugins.de/archive/2018-04-04/MBS_FileMaker_Plugin_version_8/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 16th March 2018

  
[XL.Sheet.GetName](XLSheetGetName.md) - [XL.Sheet.GetPaper](XLSheetGetPaper.md)

[HTML Version](XLSheetGetNamedRange.shtml)