Show / Hide Table of Contents

Class ExcelNamedRange

A named range.

Inheritance
object
ExcelCellBase
ExcelAddressBase
ExcelAddress
ExcelRangeBase
ExcelNamedRange
Implements
IEnumerable<ExcelRangeBase>
IEnumerable
IEnumerator<ExcelRangeBase>
IEnumerator
IDisposable
Inherited Members
ExcelRangeBase.Style
ExcelRangeBase.StyleName
ExcelRangeBase.StyleID
ExcelRangeBase.Value
ExcelRangeBase.SetErrorValue(eErrorType)
ExcelRangeBase.Text
ExcelRangeBase.Picture
ExcelRangeBase.AutoFitColumns()
ExcelRangeBase.AutoFitColumns(double)
ExcelRangeBase.AutoFitColumns(double, double)
ExcelRangeBase.Formula
ExcelRangeBase.FormulaR1C1
ExcelRangeBase.CreateHtmlExporter()
ExcelRangeBase.Hyperlink
ExcelRangeBase.SetHyperlink(Uri)
ExcelRangeBase.SetHyperlink(ExcelHyperLink)
ExcelRangeBase.SetHyperlink(ExcelRange, string)
ExcelRangeBase.SetHyperlink(ExcelRange)
ExcelRangeBase.Merge
ExcelRangeBase.AutoFilter
ExcelRangeBase.IsEmpty(bool, bool, bool)
ExcelRangeBase.IsRichText
ExcelRangeBase.IsTable
ExcelRangeBase.GetTable()
ExcelRangeBase.Insert(eShiftTypeInsert)
ExcelRangeBase.Delete(eShiftTypeDelete)
ExcelRangeBase.IsArrayFormula
ExcelRangeBase.RichText
ExcelRangeBase.Comment
ExcelRangeBase.ThreadedComment
ExcelRangeBase.Worksheet
ExcelRangeBase.FullAddress
ExcelRangeBase.FullAddressAbsolute
ExcelRangeBase.ClearFormulas()
ExcelRangeBase.ClearFormulaValues()
ExcelRangeBase.ConditionalFormatting
ExcelRangeBase.DataValidation
ExcelRangeBase.GetValue<T>()
ExcelRangeBase.Offset(int, int)
ExcelRangeBase.Offset(int, int, int, int)
ExcelRangeBase.AddComment(string, string)
ExcelRangeBase.AddThreadedComment()
ExcelRangeBase.Copy(ExcelRangeBase)
ExcelRangeBase.Copy(ExcelRangeBase, ExcelRangeCopyOptionFlags?)
ExcelRangeBase.Copy(ExcelRangeBase, params ExcelRangeCopyOptionFlags[])
ExcelRangeBase.Copy(ExcelRangeBase, ExcelRangeCopyOnly)
ExcelRangeBase.CopyFill(ExcelRangeBase)
ExcelRangeBase.CopyFill(ExcelRangeBase, params ExcelRangeCopyOptionFlags[])
ExcelRangeBase.CopyTranspose(ExcelRangeBase)
ExcelRangeBase.CopyTranspose(ExcelRangeBase, params ExcelRangeCopyOptionFlags[])
ExcelRangeBase.CopyStyles(ExcelRangeBase)
ExcelRangeBase.CopyFormulas(ExcelRangeBase)
ExcelRangeBase.CopyFormulas(ExcelRangeBase, ExcelRangeCopyOperations)
ExcelRangeBase.CopyValues(ExcelRangeBase)
ExcelRangeBase.CopyValues(ExcelRangeBase, ExcelRangeCopyOperations)
ExcelRangeBase.Clear()
ExcelRangeBase.CreateArrayFormula(string, bool)
ExcelRangeBase.FormulaRange
ExcelRangeBase.Dispose()
ExcelRangeBase.GetEnumerator()
ExcelRangeBase.Current
ExcelRangeBase.MoveNext()
ExcelRangeBase.Reset()
ExcelRangeBase.Sort()
ExcelRangeBase.Sort(int, bool)
ExcelRangeBase.Sort(int[], bool[], CultureInfo, CompareOptions)
ExcelRangeBase.Sort(Action<RangeSortOptions>)
ExcelRangeBase.Sort(RangeSortOptions)
ExcelRangeBase.EntireColumn
ExcelRangeBase.EntireRow
ExcelRangeBase.GetCellValue<T>()
ExcelRangeBase.GetCellValue<T>(int)
ExcelRangeBase.GetCellValue<T>(int, int)
ExcelRangeBase.SetCellValue(int, int, object)
ExcelRangeBase.UseImplicitItersection
ExcelRangeBase.FillNumber()
ExcelRangeBase.FillNumber(double?, double)
ExcelRangeBase.FillNumber(Action<FillNumberParams>)
ExcelRangeBase.FillDateTime()
ExcelRangeBase.FillDateTime(DateTime?, eDateTimeUnit, int)
ExcelRangeBase.FillDateTime(Action<FillDateParams>)
ExcelRangeBase.FillList<T>(IEnumerable<T>)
ExcelRangeBase.FillList<T>(IEnumerable<T>, Action<FillListParams>)
ExcelRangeBase.LoadFromDataReader(IDataReader, bool, string, TableStyles)
ExcelRangeBase.LoadFromDataReader(IDataReader, bool, string, bool, TableStyles)
ExcelRangeBase.LoadFromDataReader(IDataReader, bool)
ExcelRangeBase.LoadFromDataReader(IDataReader, bool, bool)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool, string, TableStyles, CancellationToken?)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool, string, bool, TableStyles, CancellationToken?)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool, bool)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool, CancellationToken)
ExcelRangeBase.LoadFromDataReaderAsync(DbDataReader, bool, CancellationToken, bool)
ExcelRangeBase.LoadFromDataTable(DataTable, bool, TableStyles?)
ExcelRangeBase.LoadFromDataTable(DataTable, bool, TableStyles?, bool)
ExcelRangeBase.LoadFromDataTable(DataTable, bool)
ExcelRangeBase.LoadFromDataTable(DataTable)
ExcelRangeBase.LoadFromDataTable(DataTable, Action<LoadFromDataTableParams>)
ExcelRangeBase.LoadFromArrays(IEnumerable<object[]>)
ExcelRangeBase.LoadFromArraysTransposed(IEnumerable<object[]>)
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>)
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, bool)
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, bool, TableStyles?)
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, bool, TableStyles?, bool)
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, bool, TableStyles?, BindingFlags, MemberInfo[])
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, bool, TableStyles?, bool, BindingFlags, MemberInfo[])
ExcelRangeBase.LoadFromCollection<T>(IEnumerable<T>, Action<LoadFromCollectionParams>)
ExcelRangeBase.LoadFromText(string)
ExcelRangeBase.LoadFromText(string, ExcelTextFormat)
ExcelRangeBase.LoadFromText(string, ExcelTextFormat, TableStyles?, bool)
ExcelRangeBase.LoadFromText(FileInfo)
ExcelRangeBase.LoadFromText(FileInfo, ExcelTextFormat)
ExcelRangeBase.LoadFromText(FileInfo, ExcelTextFormat, TableStyles?, bool)
ExcelRangeBase.LoadFromText(string, ExcelTextFormatFixedWidth)
ExcelRangeBase.LoadFromText(FileInfo, ExcelTextFormatFixedWidth)
ExcelRangeBase.LoadFromTextAsync(FileInfo)
ExcelRangeBase.LoadFromTextAsync(FileInfo, ExcelTextFormat)
ExcelRangeBase.LoadFromTextAsync(FileInfo, ExcelTextFormat, TableStyles, bool)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<IDictionary<string, object>>)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<IDictionary<string, object>>, bool)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<IDictionary<string, object>>, bool, TableStyles?)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<IDictionary<string, object>>, bool, TableStyles?, IEnumerable<string>)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<dynamic>, bool, TableStyles?, IEnumerable<string>)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<IDictionary<string, object>>, Action<LoadFromDictionariesParams>)
ExcelRangeBase.LoadFromDictionaries(IEnumerable<dynamic>, Action<LoadFromDictionariesParams>)
ExcelRangeBase.ToDataTable()
ExcelRangeBase.ToDataTable(Action<ToDataTableOptions>)
ExcelRangeBase.ToDataTable(ToDataTableOptions)
ExcelRangeBase.ToDataTable(Action<ToDataTableOptions>, DataTable)
ExcelRangeBase.ToDataTable(DataTable)
ExcelRangeBase.ToDataTable(ToDataTableOptions, DataTable)
ExcelRangeBase.ToText()
ExcelRangeBase.ToText(ExcelOutputTextFormat)
ExcelRangeBase.SaveToText(FileInfo, ExcelOutputTextFormat)
ExcelRangeBase.SaveToText(Stream, ExcelOutputTextFormat)
ExcelRangeBase.ToText(ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.SaveToText(FileInfo, ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.SaveToText(Stream, ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.ToTextAsync()
ExcelRangeBase.ToTextAsync(ExcelOutputTextFormat)
ExcelRangeBase.SaveToTextAsync(FileInfo, ExcelOutputTextFormat)
ExcelRangeBase.SaveToTextAsync(Stream, ExcelOutputTextFormat)
ExcelRangeBase.ToTextAsync(ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.SaveToTextAsync(FileInfo, ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.SaveToTextAsync(Stream, ExcelOutputTextFormatFixedWidth)
ExcelRangeBase.ToJson()
ExcelRangeBase.ToJson(Action<JsonRangeExportSettings>)
ExcelRangeBase.SaveToJson(Stream)
ExcelRangeBase.SaveToJson(Stream, Action<JsonRangeExportSettings>)
ExcelRangeBase.SaveToJsonAsync(Stream)
ExcelRangeBase.SaveToJsonAsync(Stream, Action<JsonRangeExportSettings>)
ExcelRangeBase.ToCollectionWithMappings<T>(Func<ToCollectionRow, T>)
ExcelRangeBase.ToCollectionWithMappings<T>(Func<ToCollectionRow, T>, Action<ToCollectionRangeOptions>)
ExcelRangeBase.ToCollectionWithMappings<T>(Func<ToCollectionRow, T>, ToCollectionRangeOptions)
ExcelRangeBase.ToCollection<T>()
ExcelRangeBase.ToCollection<T>(Action<ToCollectionRangeOptions>)
ExcelRangeBase.ToCollection<T>(ToCollectionRangeOptions)
ExcelAddress.Address
ExcelAddressBase.Start
ExcelAddressBase.End
ExcelAddressBase.ExternalReferenceIndex
ExcelAddressBase.Table
ExcelAddressBase.AddressAbsolute
ExcelAddressBase.IsName
ExcelAddressBase.Rows
ExcelAddressBase.Columns
ExcelAddressBase.IsFullRow
ExcelAddressBase.IsFullColumn
ExcelAddressBase.LocalAddress
ExcelAddressBase.IsExternal
ExcelCellBase.TranslateFromR1C1(string, int, int)
ExcelCellBase.TranslateToR1C1(string, int, int)
ExcelCellBase.GetAddressRow(int, bool)
ExcelCellBase.GetAddressCol(int, bool)
ExcelCellBase.GetAddress(int, int)
ExcelCellBase.GetAddress(int, bool, int, bool)
ExcelCellBase.GetAddress(int, int, bool)
ExcelCellBase.GetAddress(int, int, int, int)
ExcelCellBase.GetAddress(int, int, int, int, bool)
ExcelCellBase.GetAddress(int, int, int, int, bool, bool, bool, bool)
ExcelCellBase.GetFullAddress(string, string)
ExcelCellBase.GetFullAddress(string, string, string)
ExcelCellBase.IsSimpleAddress(string)
ExcelCellBase.IsValidAddress(string)
ExcelCellBase.IsValidTableAddress(string)
ExcelCellBase.IsValidRangeAddress(string)
ExcelCellBase.IsValidCellAddress(string)
object.Equals(object, object)
object.GetType()
object.ReferenceEquals(object, object)
Namespace: OfficeOpenXml
Assembly: EPPlus.dll
Syntax
public sealed class ExcelNamedRange : ExcelRangeBase, IEnumerable<ExcelRangeBase>, IEnumerable, IEnumerator<ExcelRangeBase>, IEnumerator, IDisposable

Fields

ValidateCellAddressInFormulas

Set to true to validate and update formulas with cell references.

Declaration
public static bool ValidateCellAddressInFormulas
Field Value
Type Description
bool

Properties

IsNameHidden

Is the name hidden

Declaration
public bool IsNameHidden { get; set; }
Property Value
Type Description
bool

LocalSheetId

Is the named range local for the sheet

Declaration
public int LocalSheetId { get; }
Property Value
Type Description
int

Name

Name of the range

Declaration
public string Name { get; }
Property Value
Type Description
string

NameComment

A comment for the Name

Declaration
public string NameComment { get; set; }
Property Value
Type Description
string

Methods

BeforeChangeAddress(string)

Method for actions that must be taken before address is changed

Declaration
protected override void BeforeChangeAddress(string value)
Parameters
Type Name Description
string value
Overrides
ExcelAddressBase.BeforeChangeAddress(string)

ChangeAddress(string)

On change address handler

Declaration
protected override void ChangeAddress(string value)
Parameters
Type Name Description
string value
Overrides
ExcelRangeBase.ChangeAddress(string)

Equals(object)

Returns true if the name is equal to the obj

Declaration
public override bool Equals(object obj)
Parameters
Type Name Description
object obj

The object to compare with

Returns
Type Description
bool

true if equal

Overrides
ExcelAddressBase.Equals(object)

GetFormula()

Get a formula for this name.

Declaration
public string GetFormula()
Returns
Type Description
string

GetHashCode()

Serves as the default hash function.

Declaration
public override int GetHashCode()
Returns
Type Description
int

A hash code for the current object.

Overrides
ExcelAddressBase.GetHashCode()

GetValue()

Get a value for this name.

Declaration
public object GetValue()
Returns
Type Description
object

SetFormula(string)

Set a formula for this name. Will remove exsisting range and value.

Declaration
public void SetFormula(string formula)
Parameters
Type Name Description
string formula

The formula for this name.

SetRange(ExcelRangeBase, bool)

Set a range for this name. Will remove exsisting formula and value.

Declaration
public void SetRange(ExcelRangeBase range, bool allowRelativeAddress = false)
Parameters
Type Name Description
ExcelRangeBase range
bool allowRelativeAddress

SetValue(object)

Set a value for this name. Will remove exsisting range and formula.

Declaration
public void SetValue(object value)
Parameters
Type Name Description
object value

ToString()

Returns a string representation of the object

Declaration
public override string ToString()
Returns
Type Description
string

The name of the range

Overrides
ExcelAddressBase.ToString()

Implements

IEnumerable<T>
IEnumerable
IEnumerator<T>
IEnumerator
IDisposable

Extension Methods

CalculationExtension.Calculate(ExcelRangeBase)
CalculationExtension.Calculate(ExcelRangeBase, ExcelCalculationOption)
CalculationExtension.Calculate(ExcelRangeBase, Action<ExcelCalculationOption>)
RangeExtensions.SkipColumns(ExcelRangeBase, int)
RangeExtensions.SkipRows(ExcelRangeBase, int)
RangeExtensions.TakeColumns(ExcelRangeBase, int)
RangeExtensions.TakeColumnsBetween(ExcelRangeBase, int, int)
RangeExtensions.TakeRows(ExcelRangeBase, int)
RangeExtensions.TakeRowsBetween(ExcelRangeBase, int, int)
RangeExtensions.TakeSingleCell(ExcelRangeBase, int, int)
RangeExtensions.TakeSingleColumn(ExcelRangeBase, int)
RangeExtensions.TakeSingleRow(ExcelRangeBase, int)
In this article
Back to top Generated by DocFX