【C#】【EXCEL】Bumblebee/Classes/ExCell.cs

Bumblebee/Classes/ExCell.cs

Flow diagram

默认构造函数
Default Constructor 复制构造函数
Copy Constructor 地址构造函数
Address Constructor 列行构造函数
Column-Row Constructor 列行绝对值构造函数
Column-Row-Absolute Constructor 获取/设置属性
Get/Set Properties 地址转换
Address Conversion 其他操作
Other Operations 开始 / Start 创建 ExCell 实例
Create ExCell Instance 选择构造方法
Choose Constructor 创建默认 ExCell
Create Default ExCell 复制现有 ExCell
Copy Existing ExCell 从地址创建 ExCell
Create ExCell from Address 从列和行创建 ExCell
Create ExCell from Column and Row 创建带绝对引用的 ExCell
Create ExCell with Absolute References 选择操作类型
Choose Operation Type 属性操作
Property Operations 地址转换操作
Address Conversion Operations 其他操作
Other Operations 获取/设置 Column
Get/Set Column 获取/设置 Row
Get/Set Row 获取/设置 Address
Get/Set Address 获取 IsColumnAbsolute
Get IsColumnAbsolute 获取 IsRowAbsolute
Get IsRowAbsolute 地址到列行转换
Address to Column-Row 列行到地址转换
Column-Row to Address 解析绝对引用
Parse Absolute References ToString 方法
ToString Method 完成属性操作
Property Operations Completed 完成地址转换操作
Address Conversion Completed 完成其他操作
Other Operations Completed 结束 / End

这个流程图展示了ExCell类的主要结构:

  1. 类的主要组成部分:成员变量、构造函数、属性和方法。
  2. 成员变量:column, row, isColumnAbsolute, isRowAbsolute。
  3. 不同的构造函数。
  4. 属性:Column, Row, Address, IsColumnAbsolute, IsRowAbsolute。
  5. ToString方法。
  6. Address属性的特殊处理,包括使用Helper类的方法进行地址转换。

Description

  1. 开始 / Start

    这是流程的起点,代表我们开始使用 ExCell 类。

  2. 创建 ExCell 实例 / Create ExCell Instance

    这对应于代码中的构造函数部分。

    csharp 复制代码
    public class ExCell
    {
        // 构造函数 / Constructors
        public ExCell() { }
        public ExCell(ExCell cell) { ... }
        public ExCell(string address) { ... }
        public ExCell(int column, int row) { ... }
        public ExCell(int column, int row, bool absColumn, bool absRow) { ... }
    }
  3. 选择构造方法 / Choose Constructor

    根据需求选择不同的构造函数来创建 ExCell 实例。

  4. 属性操作 / Property Operations

    这对应于代码中的属性部分。

    csharp 复制代码
    public virtual int Column { get; set; }
    public virtual int Row { get; set; }
    public virtual string Address { get; set; }
    public virtual bool IsColumnAbsolute { get; }
    public virtual bool IsRowAbsolute { get; }
  5. 地址转换操作 / Address Conversion Operations

    这主要对应于 Address 属性的 get 和 set 方法。

    csharp 复制代码
    public virtual string Address
    {
        get { return Helper.GetCellAddress(column,row,IsColumnAbsolute,isRowAbsolute); }
        set
        {
            Tuple<int, int> loc = Helper.GetCellLocation(value);
            Tuple<bool, bool> abs = Helper.GetCellAbsolute(value);
            // ... set values ...
        }
    }
  6. 其他操作 / Other Operations

    这包括 ToString 方法。

    csharp 复制代码
    public override string ToString()
    {
        return this.Address;
    }
  7. 成员变量 / Member Variables

    虽然流程图中没有直接显示,但这些是类的基础。

    csharp 复制代码
    protected int column = 1;
    protected int row = 1;
    protected bool isColumnAbsolute = false;
    protected bool isRowAbsolute = false;

流程图展示了使用 ExCell 类的典型过程:

  1. 创建实例
  2. 对实例进行各种操作(如获取/设置属性,进行地址转换)
  3. 完成操作
csharp 复制代码
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Bumblebee
{
    /// <summary>
    /// ExCell类代表Excel中的一个单元格
    /// 它包含单元格的列、行信息,以及是否为绝对引用
    /// </summary>
    public class ExCell
    {
        #region 成员变量

        // 单元格的列号,默认为1
        protected int column = 1;
        // 单元格的行号,默认为1
        protected int row = 1;
        // 列引用是否为绝对引用,默认为false
        protected bool isColumnAbsolute = false;
        // 行引用是否为绝对引用,默认为false
        protected bool isRowAbsolute = false;

        #endregion

        #region 构造函数

        /// <summary>
        /// 默认构造函数,创建一个位于A1的单元格
        /// </summary>
        public ExCell()
        {
        }

        /// <summary>
        /// 复制构造函数,创建一个与给定单元格相同的新单元格
        /// </summary>
        /// <param name="cell">要复制的单元格</param>
        public ExCell(ExCell cell)
        {
            this.column = cell.column;
            this.row = cell.row;
            this.isColumnAbsolute = cell.isColumnAbsolute;
            this.isRowAbsolute = cell.isRowAbsolute;
        }

        /// <summary>
        /// 通过地址字符串创建单元格
        /// </summary>
        /// <param name="address">单元格地址,如"A1"或"$B$2"</param>
        public ExCell(string address)
        {
            this.Address = address;
        }

        /// <summary>
        /// 通过列号和行号创建单元格
        /// </summary>
        /// <param name="column">列号</param>
        /// <param name="row">行号</param>
        public ExCell(int column, int row)
        {
            this.column = column;
            this.row = row;
        }

        /// <summary>
        /// 创建可能包含绝对引用的单元格
        /// </summary>
        /// <param name="column">列号</param>
        /// <param name="row">行号</param>
        /// <param name="absColumn">列是否为绝对引用</param>
        /// <param name="absRow">行是否为绝对引用</param>
        public ExCell(int column, int row, bool absColumn, bool absRow)
        {
            this.column = column;
            this.row = row;
            this.isColumnAbsolute = absColumn;
            this.isRowAbsolute = absRow;
        }

        #endregion

        #region 属性

        /// <summary>
        /// 获取或设置单元格的列号
        /// </summary>
        public virtual int Column
        {
            get { return column; }
            set { 
                this.column = value;
            }
        }

        /// <summary>
        /// 获取或设置单元格的行号
        /// </summary>
        public virtual int Row
        {
            get { return row; }
            set
            {
                this.row = value;
            }
        }

        /// <summary>
        /// 获取或设置单元格的地址
        /// 当获取时,会根据当前的列、行和绝对引用信息生成地址字符串
        /// 当设置时,会解析地址字符串,更新列、行和绝对引用信息
        /// </summary>
        public virtual string Address
        {
            get { return Helper.GetCellAddress(column, row, IsColumnAbsolute, isRowAbsolute); }
            set
            {
                // 解析地址字符串,获取列和行的信息
                Tuple<int, int> loc = Helper.GetCellLocation(value);
                // 解析地址字符串,获取绝对引用的信息
                Tuple<bool, bool> abs = Helper.GetCellAbsolute(value);

                this.column = loc.Item1;
                this.row = loc.Item2;
                this.isColumnAbsolute = abs.Item1;
                this.isRowAbsolute = abs.Item2;
            }
        }

        /// <summary>
        /// 获取列引用是否为绝对引用
        /// </summary>
        public virtual bool IsColumnAbsolute
        {
            get { return isColumnAbsolute; }
        }

        /// <summary>
        /// 获取行引用是否为绝对引用
        /// </summary>
        public virtual bool IsRowAbsolute
        {
            get { return isRowAbsolute; }
        }

        #endregion

        #region 方法

        // 此区域为空,可以在此添加自定义方法

        #endregion

        #region 重写

        /// <summary>
        /// 重写ToString方法,返回单元格的地址
        /// </summary>
        /// <returns>单元格的地址字符串</returns>
        public override string ToString()
        {
            return this.Address;
        }

        #endregion
    }
}
相关推荐
Your易元18 分钟前
设计模式-模板方法模式
java·设计模式·模板方法模式
risc1234561 小时前
Elasticsearch 线程池
java·大数据·elasticsearch
NE_STOP2 小时前
SpringBoot--如何整体读取多个配置属性及其相关操作
java·spring
CodeCraft Studio2 小时前
PPT处理控件Aspose.Slides教程:使用 C# 将 PPTX 转换为 EMF
c#·powerpoint·ppt·aspose·ppt格式转换
apihz2 小时前
通用图片搜索-搜狗源免费API接口使用指南
android·java·python·php·音视频
风象南2 小时前
基于 SpringBoot 的 REST API 与 RPC 调用的统一封装
java·spring boot·后端
素雪风华2 小时前
Jenkins+Gitee+Docker容器化部署
java·docker·gitee·jenkins·springboot·持续部署
future14123 小时前
游戏开发日记7.12
数据结构·学习·c#·游戏开发
用户40315986396633 小时前
带 WriteBuffer 的内存读写操作
java·算法
岁忧3 小时前
(LeetCode 面试经典 150 题 ) 209. 长度最小的子数组(双指针)
java·c++·算法·leetcode·面试·go