Skip to main content

Cells and Cell Ranges in Spreadsheet Documents

  • 4 minutes to read

All worksheet data is stored in cells. Each cell can only hold and display a single piece of data - the cell value. A cell can also contain a formula that calculates the cell value dynamically.

An individual cell is a box at the intersection of a column and row. Thus, a cell reference is usually a combination of a column letter and a row number. For example, C3 refers to a cell that belongs to column C and row 3. Other cell reference styles are also supported.

You can format cells to improve worksheet appearance, and make it easy for end-users to read and understand its content.

When working with worksheet data, you can access and modify individual cells (Cell) as well as cell ranges (CellRange). The CellRange interface provides the basic functionality required to work with worksheet cells.

Property/Method

Description

Example

CellCollection.Item, Worksheet.Item

Row.Item, Column.Item, CellRange.Item

Access an individual cell from a worksheet’s collection of all cells, from a particular row or column, or from any range of cells.

How to: Access a Cell in a Worksheet

Worksheet.Range

Worksheet.GetUsedRange

When working with a worksheet (for example, formatting cells or processing data), you can manipulate not only individual cells but also cell ranges. You can access a range of contiguous cells (CellRange) or a cell range that includes the entire content of a worksheet (the worksheet’s used range).

How to: Access a Range of Cells

CellRange.GetReferenceA1, CellRange.GetReferenceR1C1

Return a cell or cell range reference in the corresponding cell reference style.

How to: Use Cell and Worksheet References in Formulas

Cell.ColumnIndex, Cell.RowIndex

CellRange.TopRowIndex, CellRange.BottomRowIndex, CellRange.LeftColumnIndex, CellRange.RightColumnIndex, CellRange.RowCount, CellRange.ColumnCount

For an individual cell, you can obtain indexes of the row and column to which this cell belongs.

For a range of cells, you can get indexes of its bound rows and columns, and obtain the number of rows and columns in the range.

CellRange.Value

Sets data of a specified type to a cell or a cell range. You can also use this property to retrieve information about the type of a cell’s actual value, and get the cell value itself as an object of the corresponding type. If a cell contains a formula, this property returns a value resulting from the formula.

For more information, see the Cell Data Types document.

How to: Change a Cell or Cell Range Value

Cell.DisplayText

Gets a cell value as it is displayed.

CellRange.Formula

CellRange.ArrayFormula, CellRange.HasArrayFormula, Cell.IsTopLeftCellInArrayFormulaRange

Use formulas in cells to dynamically perform calculations on worksheet data. Values displayed in cells with formulas are automatically recalculated and updated after processed data has been changed.

How to: Add Formulas to Cells

How to: Create Shared Formulas

How to: Create Array Formulas

Worksheet.InsertCells

Inserts empty cells in a worksheet, above or to the left of the specified cell or cell range, shifting other cells in the same row to the right and cells in the same column down.

How to: Insert a Cell or Cell Range

CellRange.CopyFrom

Copy information (all information, values only, formats only, borders only, etc.) from cells to other cells.

How to: Copy Cell Data Only, Cell Style Only, or Cell Data with Style

Worksheet.ClearContents

Worksheet.ClearFormats

Worksheet.ClearComments

Worksheet.ClearHyperlinks

Worksheet.Clear

Remove content, formats, hyperlinks, comments or all information from cells.

How to: Clear Cells of Content, Formatting, Hyperlinks and Comments

CellRange.BeginUpdateFormatting - CellRange.EndUpdateFormatting

CellRange.Style

CellRange.FillColor

Formatting.Fill

Formatting.Font

Formatting.NumberFormat

Formatting.NumberFormatLocal

Formatting.Alignment

Formatting.Borders, CellRange.SetInsideBorders

Format an individual cell or a cell range using styles, or by directly changing and setting the required formatting characteristics for a cell or a range of cells.

For details, see Formatting Cells.

Formatting Cells

CellRange.IsIntersecting

CellRange.Intersect

Allow you to determine whether or not cell ranges intersect, and obtain the intersection of ranges.

CellRange.Name

Worksheet.DefinedNames, DefinedNameCollection.Add

You can name individual cells and cell ranges (as well as formulas and constants), making it easier to understand the purpose of named cells, and as a result, making it easier to use them.

For more information, refer to the Defined Names topic.

How to: Create a Named Range of Cells

Worksheet.DeleteCells

Deletes cells from a worksheet, shifting other cells in the same row to the left, and cells in the same column up.

How to: Delete a Cell or Range of Cells

Worksheet.Hyperlinks

HyperlinkCollection.Add

HyperlinkCollection.GetHyperlinks

Insert hyperlinks into cells.

How to: Add a Hyperlink to a Cell

Worksheet.Comments

CommentCollection.Add

CommentCollection.GetComments

Associate cells with comments.

How to: Add a Comment To a Cell

Worksheet.MergeCells, Worksheet.UnMergeCells

Merge several adjacent cells into one cell, and split merged cells.

How to: Merge Cells or Split Merged Cells

CellRangeExtensions.ExportToImage

Allows you to export a cell range as an image.

How to: Save a Cell Range as an Image

See Also