美文网首页
Go语言excelize包-02-工作表操作(新建/删除/复制/

Go语言excelize包-02-工作表操作(新建/删除/复制/

作者: 玄德公笔记 | 来源:发表于2022-09-07 23:12 被阅读0次

    1. 新建工作表

    • 语法
    func (f *File) NewSheet(sheet string) int
    
    • 示例

    见 1.1

    2. 删除工作表

    func (f *File) DeleteSheet(sheet string)
    

    3. 复制工作表

    将第"x"张表的内容,复制到已有的第“y”张表。

    • 语法
    func (f *File) CopySheet(from, to int) error
    
    • 示例
    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        // 创建工作表
        indexXiShu := f.NewSheet("西蜀")
        f.NewSheet("东吴")
        f.NewSheet("曹魏")
        // 向表中单元格写入数据
        f.SetCellValue("西蜀", "B2", "刘备")
        f.SetCellValue("西蜀", "B3", "关羽")
        f.SetCellValue("西蜀", "B4", "张飞")
        f.SetCellValue("东吴", "B2", "孙权")
        f.SetCellValue("曹魏", "B2", "曹操")
        //第1张表的内容复制到第2张表(从0号开始计)
        f.CopySheet(1,2)
        // 设置工作簿的默认工作表
        f.SetActiveSheet(indexXiShu)
        // 根据指定路径保存文件
        if err := f.SaveAs("sanGuo.xlsx"); err != nil {
            fmt.Println(err)
        }
    }
    

    说明:

    • 创建的代码创建了四张表: sheet1(创建工作簿时默认创建)、"西蜀"、“东吴”、“曹魏”
    • 从第1张表复制(0号开始计),即复制“西蜀”表
    • 复制到第2张表,即复制到“东吴表”
    • 如果目标表的值超出了已有表,则不会新创建(什么也不会发生)
    • 查看结果
      如下可见,“东吴”表复制了“西蜀”表的内容。且原有内容被覆盖。


      image.png

    4. 工作表分组

    4.1 创建组

    • 语法
    func (f *File) GroupSheets(sheets []string) error
    
    • 示例
    err = f.GroupSheets([]string{"西蜀","东吴"})
    

    4.2 删除分组

    • 语法
    func (f *File) UngroupSheets() error
    
    • 示例
    err := f.UngroupSheets()
    

    5. 默认工作表

    5.1 设置默认工作表

    • 语法
    func (f *File) SetActiveSheet(index int)
    
    • 示例

    见 1.1

    5.2 获取默认工作表

    • 语法
    func (f *File) GetActiveSheetIndex() int
    

    6. 工作表可见性

    6.1 设置工作表可见性

    • 语法
    func (f *File) SetSheetVisible(sheet string, visible bool) error
    

    visible 的值 true表示可见,flase表示不可见。

    • 示例

    隐藏东吴表

    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        // 创建工作表
        indexXiShu := f.NewSheet("西蜀")
        f.NewSheet("东吴")
        f.NewSheet("曹魏")
        // 向表中单元格写入数据
        f.SetCellValue("西蜀", "B2", "刘备")
        f.SetCellValue("西蜀", "B3", "关羽")
        f.SetCellValue("西蜀", "B4", "张飞")
        f.SetCellValue("东吴", "B2", "孙权")
        f.SetCellValue("曹魏", "B2", "曹操")
        f.SetSheetVisible("东吴",false)
    
        // 设置工作簿的默认工作表
        f.SetActiveSheet(indexXiShu)
        // 根据指定路径保存文件
        if err := f.SaveAs("sanGuo.xlsx"); err != nil {
            fmt.Println(err)
        }
    }
    
    • 结果显示


      image.png

    如图可见,东吴表被隐藏。

    6.2 获取工作表可见性

    • 代码
    func (f *File) GetSheetVisible(sheet string) bool
    
    • 示例

    上例中添加如下代码:

    statusDongWu := f.GetSheetVisible("东吴")
    fmt.Printf("东吴表的状态是:%t ",statusDongWu)
    

    结果显示

    东吴表的状态是:false
    

    7. 表格整体属性

    • 语法
    func (f *File) SetSheetFormatPr(sheet string, opts ...SheetFormatPrOptions) error
    
    • 可选参数
    可选格式参数 作用 数据类型
    BaseColWidth 基础宽度 uint8
    DefaultColWidth 默认列宽 float64
    DefaultRowHeight 默认行高 float64
    CustomHeight 自定义高度 bool
    ZeroHeight 表格高仅为有内容的部分 bool
    ThickTop 顶部厚 bool
    ThickBottom 底部厚 bool

    7.1 自定义列宽

    • 语法示例
    f.SetSheetFormatPr("西蜀",excelize.DefaultColWidth(30.0))
    

    或者

    f.SetSheetFormatPr("西蜀",excelize.BaseColWidth(30))
    
    • 完整示例
    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        // 创建工作表
        indexXiShu := f.NewSheet("西蜀")
        // 向表中单元格写入数据
        f.SetCellValue("西蜀", "A1", "刘备")
        f.SetCellValue("西蜀", "A2", "关羽")
        f.SetCellValue("西蜀", "A3", "张飞")
        f.SetSheetFormatPr("西蜀",excelize.DefaultColWidth(30.0))
    
        // 设置工作簿的默认工作表
        f.SetActiveSheet(indexXiShu)
        // 根据指定路径保存文件
        if err := f.SaveAs("sanGuo.xlsx"); err != nil {
            fmt.Println(err)
        }
    }
    
    • 结果显示


      image.png

    7.2 自定义行高

    • 语法示例

    处设置默认列宽之外还需要设置 自定义列宽为true

    f.SetSheetFormatPr("西蜀",excelize.DefaultRowHeight(30.0),excelize.CustomHeight(true))
    
    • 完整示例
    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        // 创建工作表
        indexXiShu := f.NewSheet("西蜀")
    
        // 向表中单元格写入数据
        f.SetCellValue("西蜀", "A1", "刘备")
        f.SetCellValue("西蜀", "A2", "关羽")
        f.SetCellValue("西蜀", "A3", "张飞")
        f.SetSheetFormatPr("西蜀",excelize.DefaultRowHeight(30.0),excelize.CustomHeight(true))
    
        // 设置工作簿的默认工作表
        f.SetActiveSheet(indexXiShu)
        // 根据指定路径保存文件
        if err := f.SaveAs("sanGuo.xlsx"); err != nil {
            fmt.Println(err)
        }
    }
    
    • 结果显示


      image.png

    7.3 行高为内容部分

    • 语法示例
    f.SetSheetFormatPr("西蜀",excelize.ZeroHeight(true))
    
    • 完整示例
    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        // 创建工作表
        indexXiShu := f.NewSheet("西蜀")
    
        // 向表中单元格写入数据
        f.SetCellValue("西蜀", "A1", "刘备")
        f.SetCellValue("西蜀", "A2", "关羽")
        f.SetCellValue("西蜀", "A3", "张飞")
        f.SetSheetFormatPr("西蜀",excelize.ZeroHeight(true))
    
        // 设置工作簿的默认工作表
        f.SetActiveSheet(indexXiShu)
        // 根据指定路径保存文件
        if err := f.SaveAs("sanGuo.xlsx"); err != nil {
            fmt.Println(err)
        }
    }
    
    • 结果显示


      image.png

    7.4 获取表格属性

    • 语法
    func (f *File) GetSheetFormatPr(sheet string, opts ...SheetFormatPrOptionsPtr) error
    
    • 完整示例

    说明:该示例摘自官方文档。

    package main
    
    import (
        "fmt"
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        const sheet = "Sheet1"
    
        var (
            baseColWidth     excelize.BaseColWidth
            defaultColWidth  excelize.DefaultColWidth
            defaultRowHeight excelize.DefaultRowHeight
            customHeight     excelize.CustomHeight
            zeroHeight       excelize.ZeroHeight
            thickTop         excelize.ThickTop
            thickBottom      excelize.ThickBottom
        )
    
        if err := f.GetSheetFormatPr(sheet,
            &baseColWidth,
            &defaultColWidth,
            &defaultRowHeight,
            &customHeight,
            &zeroHeight,
            &thickTop,
            &thickBottom,
        ); err != nil {
            fmt.Println(err)
        }
        fmt.Println("Defaults:")
        fmt.Println("- baseColWidth:", baseColWidth)
        fmt.Println("- defaultColWidth:", defaultColWidth)
        fmt.Println("- defaultRowHeight:", defaultRowHeight)
        fmt.Println("- customHeight:", customHeight)
        fmt.Println("- zeroHeight:", zeroHeight)
        fmt.Println("- thickTop:", thickTop)
        fmt.Println("- thickBottom:", thickBottom)
    }
    
    • 结果显示
    Defaults:
    - baseColWidth: 0
    - defaultColWidth: 0
    - defaultRowHeight: 15
    - customHeight: false
    - zeroHeight: false
    - thickTop: false
    - thickBottom: false
    

    8. 表名

    8.1 根据索引获取工作表名

    • 语法
    func (f *File) GetSheetName(index int) (name string)
    
    • 示例
    package main
    
    import (
        "fmt"
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        sheetName := f.GetSheetName(0)
        fmt.Println(sheetName)
    }
    

    结果显示

    Sheet1
    

    8.2 根据表名获取工作表索引

    • 语法
    func (f *File) GetSheetIndex(sheet string) int
    

    表不存在返回-1

    8.3 获取工作表列表

    func (f *File) GetSheetList() []string
    

    8.4 修改工作表名

    • 语法
    func (f *File) SetSheetName(oldName, newName string)
    
    • 完整示例
    package main
    
    import (
        "fmt"
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
        fmt.Println("修改前0号表表名:",f.GetSheetName(0))
        f.SetSheetName("Sheet1","xiShu")
        fmt.Println("修改后0号表表名:",f.GetSheetName(0))
    
    }
    

    结果显示

    修改前0号表表名: Sheet1
    修改后0号表表名: xiShu
    

    9. 表查询

    • 语法
    func (f *File) SearchSheet(sheet string, value string, reg ...bool) ([]string, error)
    

    说明:

    • sheet :表名
    • value:要查找的字串
    • reg:是否匹配正则
    • 完整示例
    package main
    
    import (
        "fmt"
    
        "github.com/xuri/excelize/v2"
    )
    
    func main() {
        f := excelize.NewFile()
    
        // 向表中单元格写入数据
        f.SetCellValue("Sheet1", "A1", "刘备")
        f.SetCellValue("Sheet1", "A2", "诸葛亮")
        f.SetCellValue("Sheet1", "A3", "关羽")
        f.SetCellValue("Sheet1", "A4", "张飞")
        f.SetCellValue("Sheet1", "A5", "赵云")
        f.SetCellValue("Sheet1", "A6", "马超")
        f.SetCellValue("Sheet1", "A7", "黄忠")
        f.SetCellValue("Sheet1", "A8", "关兴")
        f.SetCellValue("Sheet1", "A9", "关平")
        //精确查找
        result1,_ := f.SearchSheet("Sheet1","关羽")
        //正则匹配
        result2,_ := f.SearchSheet("Sheet1","^关.*",true)
        fmt.Printf("精确搜索:%+v\n正则匹配: %+v",result1,result2)
    }
    
    • 打印结果
    精确搜索:[A3]
    正则匹配: [A3 A8 A9]
    

    相关文章

      网友评论

          本文标题:Go语言excelize包-02-工作表操作(新建/删除/复制/

          本文链接:https://www.haomeiwen.com/subject/mshanrtx.html