Como Adicionar, Extrair e Remover Imagens em Planilha Excel com C# e IronXL

Como Posso Adicionar Imagens em Planilhas do Excel?

To insert an image into a spreadsheet, use the InsertImage method, which supports various image types including JPG/JPEG, BMP, PNG, GIF, and TIFF. Esta capacidade é particularmente útil quando você precisa criar gráficos do Excel em C# e suplementá-los com elementos visuais adicionais. Especifique os cantos superior esquerdo e inferior direito da imagem para determinar suas dimensões, calculadas subtraindo os valores das colunas e linhas.

A assinatura do método requer cinco parâmetros: o caminho do arquivo da imagem e quatro inteiros representando a coluna inicial, linha inicial, coluna final e linha final. A imagem será esticada ou comprimida para se ajustar ao intervalo de células definido. Por exemplo:

• Para um tamanho de imagem 1x1:
  • worksheet.InsertImage("image.gif", 5, 1, 6, 2);
• Para um tamanho de imagem 2x2:
  • worksheet.InsertImage("image.gif", 5, 1, 7, 3);

Ao trabalhar com imagens no Excel, entenda como o IronXL as gerencia internamente. Cada imagem inserida recebe um ID único que segue um padrão específico.

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-insert.cs

using IronXL;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Insert images
workSheet.InsertImage("ironpdf.jpg", 2, 2, 4, 4);
workSheet.InsertImage("ironpdfIcon.png", 2, 6, 4, 8);

workBook.SaveAs("insertImages.xlsx");

Imports IronXL

Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Insert images
workSheet.InsertImage("ironpdf.jpg", 2, 2, 4, 4)
workSheet.InsertImage("ironpdfIcon.png", 2, 6, 4, 8)

workBook.SaveAs("insertImages.xlsx")

O método InsertImage oferece flexibilidade para posicionar e dimensionar imagens dentro da sua planilha. Diferentemente da inserção manual de imagens no Excel, a inserção programática garante um posicionamento consistente em vários arquivos, tornando-o ideal para gerar relatórios ou documentos que exigem formatação padronizada. Esta abordagem é particularmente benéfica quando trabalhando com Excel em C# sem Interop, pois elimina dependências de instalações do Microsoft Office.

Como se Parece a Imagem Inserida no Excel?

Como Posso Extrair Imagens de Arquivos do Excel?

To extract images from the selected worksheet, access the Images property, which provides a list of all images contained within the sheet. Este recurso é essencial quando você precisa carregar arquivos do Excel sem Interop e processar seu conteúdo visual incorporado. Desta lista, você pode realizar várias operações, como exportar, redimensionar, recuperar posições e obter os dados de bytes de cada imagem. Os IDs de imagem seguem um padrão de números ímpares, incrementando na sequência de 1, 3, 5, 7 e assim por diante.

O processo de extração fornece acesso abrangente às propriedades e dados das imagens, permitindo que os desenvolvedores:

• Exportem imagens para vários formatos (PNG, JPEG, BMP, etc.)
• Recuperem informações de posicionamento de imagens para preservação do layout
• Acessar dados brutos de bytes para processamento ou armazenamento personalizado
• Redimensionar imagens programaticamente sem bibliotecas externas de processamento de imagem

Esta funcionalidade se mostra inestimável ao migrar conteúdo entre diferentes formatos de documentos ou ao construir sistemas que precisam catalogar e gerenciar ativos visuais de arquivos do Excel. A capacidade de extrair imagens programaticamente também apoia processos automatizados de controle de qualidade em que as imagens precisam de validação ou processamento de acordo com regras de negócios específicas.

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-extract.cs

using IronSoftware.Drawing;
using IronXL;
using IronXL.Drawing;
using System;
using System.Collections.Generic;

WorkBook workBook = WorkBook.Load("insertImages.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retreive images
List<IronXL.Drawing.Images.IImage> images = workSheet.Images;

// Select each image
foreach (IronXL.Drawing.Images.IImage image in images)
{
    // Save the image
    AnyBitmap anyBitmap = image.ToAnyBitmap();
    anyBitmap.SaveAs($"{image.Id}.png");

    // Resize the image
    image.Resize(1,3);

    // Retrieve image position
    Position position = image.Position;
    Console.WriteLine("top row index: " + position.TopRowIndex);
    Console.WriteLine("bottom row index: " + position.BottomRowIndex);

    // Retrieve byte data
    byte[] imageByte = image.Data;
}

workBook.SaveAs("resizeImage.xlsx");

Imports IronSoftware.Drawing
Imports IronXL
Imports IronXL.Drawing
Imports System
Imports System.Collections.Generic

Private workBook As WorkBook = WorkBook.Load("insertImages.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Retreive images
Private images As List(Of IronXL.Drawing.Images.IImage) = workSheet.Images

' Select each image
For Each image As IronXL.Drawing.Images.IImage In images
	' Save the image
	Dim anyBitmap As AnyBitmap = image.ToAnyBitmap()
	anyBitmap.SaveAs($"{image.Id}.png")

	' Resize the image
	image.Resize(1,3)

	' Retrieve image position
	Dim position As Position = image.Position
	Console.WriteLine("top row index: " & position.TopRowIndex)
	Console.WriteLine("bottom row index: " & position.BottomRowIndex)

	' Retrieve byte data
	Dim imageByte() As Byte = image.Data
Next image

workBook.SaveAs("resizeImage.xlsx")

Imagens Extraídas

Tamanho da Imagem

Como Remover Imagens de Planilhas do Excel?

Following the extract images example, you can easily remove any inserted image using its corresponding index number. Passe o número ID da imagem para o método RemoveImage para removê-la da planilha. Esta operação é particularmente útil quando você precisa editar arquivos do Excel em C# para limpar elementos visuais indesejados ou preparar documentos para diferentes audiências.

O processo de remoção é simples, mas requer compreensão do sistema de identificação de imagens. Como a IronXL atribui IDs em uma sequência de números ímpares (1, 3, 5, 7...), rastreie esses IDs ao gerenciar várias imagens. Considere implementar um sistema de mapeamento em sua aplicação para associar nomes significativos aos IDs das imagens para facilitar a gestão.

:path=/static-assets/excel/content-code-examples/how-to/add-remove-extract-worksheet-images-remove.cs

using IronXL;

WorkBook workBook = WorkBook.Load("insertImages.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove image
workSheet.RemoveImage(3);

workBook.SaveAs("removeImage.xlsx");

Imports IronXL

Private workBook As WorkBook = WorkBook.Load("insertImages.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Remove image
workSheet.RemoveImage(3)

workBook.SaveAs("removeImage.xlsx")

Para cenários mais complexos envolvendo várias planilhas e imagens, explore gerenciamento de planilhas para entender como as operações de imagens interagem com operações de nível de planilha. Além disso, ao trabalhar com arquivos Excel protegidos, consulte nosso guia sobre proteção de arquivos Excel para entender como as operações de imagem funcionam com pastas de trabalho protegidas por senha.