officefileapi-14923-spreadsheet-document-api-spreadsheet-document-cells-and-cell-ranges.md
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. 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
| |
|
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.
| | |
|
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
| |
|
Gets a cell value as it is displayed.
| | |
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: Create Shared Formulas
| |
|
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
| |
|
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
| |
|
Remove content, formats, hyperlinks, comments or all information from cells.
|
How to: Clear Cells of Content, Formatting, Hyperlinks and Comments
| |
CellRange.BeginUpdateFormatting - CellRange.EndUpdateFormatting
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.
|
| |
|
Allow you to determine whether cell ranges intersect, and obtain the intersection of ranges.
| | |
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
| |
|
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
| |
HyperlinkCollection.GetHyperlinks
|
Insert hyperlinks into cells.
|
How to: Add a Hyperlink to a Cell
| |
|
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