Excel'de C# Kullanarak Görüntü Ekleme, Çıkarma ve Kaldırma Nasıl Yapılır

Excel İş Sayfalarına Nasıl Görüntü Eklerim?

Bir tabloya resim eklemek için, JPG/JPEG, BMP, PNG, GIF ve TIFF dahil olmak üzere çeşitli resim türlerini destekleyen InsertImage yöntemini kullanın. C#'te Excel grafiklerini programatik olarak oluşturduğunuzda ve bunları ek görsel unsurlarla takviye etmeyi istediğinizde bu imkan özellikle kullanışlıdır. Görüntünün boyutunu belirlemek için sol üst ve sağ alt köşelerini belirtin, sütun ve satır değerlerini çıkararak hesaplanır.

Yöntem imzası beş parametre gerektirir: görüntü dosya yolu ve başlangıç sütunu, başlangıç satırı, bitiş sütunu ve bitiş satırını temsil eden dört tamsayı. Görüntü, tanımlanan hücre aralığına uyması için uzatılır veya sıkıştırılır. Örneğin:

• 1x1 görüntü boyutu için:
  • worksheet.InsertImage("image.gif", 5, 1, 6, 2);
• 2x2 görüntü boyutu için:
  • worksheet.InsertImage("image.gif", 5, 1, 7, 3);

Excel'de görüntülerle çalışırken, IronXL'nin bunları dahili olarak nasıl yönettiğini anlayın. Eklenen her görüntü, belirli bir deseni izleyen benzersiz bir ID alır.

: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")

InsertImage yöntemi, çalışma sayfanızdaki görüntülerin konumlandırılması ve boyutlandırılması konusunda esneklik sağlar. Excel'de manuel görüntü eklemeyle karşılaştırıldığında, programatik ekleme, standart formatlama gerektiren raporlar veya belgeler oluştururken çoklu dosyalarda tutarlı yerleşimi garanti eder. Bu yaklaşım, Excel ile C# ortamında Interop olmadan çalışırken özellikle faydalıdır çünkü Microsoft Office kurulumlarına bağımlılığı ortadan kaldırır.

Eklenmiş Görüntü Excel'de Nasıl Görünür?

Excel Dosyalarından Görüntüleri Nasıl Çıkarırım?

To extract images from the selected worksheet, access the Images property, which provides a list of all images contained within the sheet. Interop olmadan Excel dosyalarını yükleme ve gömülü görsel içeriği işleme ihtiyaç duyduğunuzda bu özellik esastır. Bu listeden, dışa aktarma, boyutlandırma, konumları alma ve her görüntünün byte verilerini elde etme gibi çeşitli işlemler gerçekleştirebilirsiniz. Görüntü kimlikleri, 1, 3, 5, 7 ve devam eden bir sekansla tek sayıyla artan bir deseni takip eder.

Çıkarma süreci, görüntü özellik ve verilerine kapsamlı erişim sağlar, geliştiricilerin şunları yapmasını mümkün kılar:

• Görüntüleri farklı formatlara (PNG, JPEG, BMP, vb.) dışa aktarın
• Düzeni koruma için görüntü konumlandırma bilgilerini alın
• Özelleştirilmiş işlem veya depolama için ham byte verilerine erişin
• Harici görüntü işleme kütüphaneleri olmadan görüntüleri programatik olarak boyutlandırın

Bu işlevsellik, içeriği farklı belge formatları arasında taşırken veya Excel dosyalarından görsel varlıkları kataloglamak ve yönetmek için sistemler oluştururken çok değerli hale gelir. Programatik olarak görüntü çıkarma yeteneği ayrıca belirli iş kurallarına göre görüntülerin doğrulamaya veya işlemeye ihtiyaç duyduğu otomatik kalite kontrol süreçlerini de destekler.

: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")

Çıkarılan Görüntüler

Görüntü Boyutu

Excel İş Sayfalarından Görüntüleri Nasıl Kaldırırım?

Following the extract images example, you can easily remove any inserted image using its corresponding index number. Görüntünün kimlik numarasını RemoveImage yöntemine aktararak onu çalışma sayfasından kaldırın. C# ortamında Excel dosyalarını düzenlemeniz gerektiğinde, istenmeyen görsel unsurları temizlemek veya belgeleri farklı kitlelere hazırlamak için bu işlem özellikle kullanışlıdır.

Kaldırma işlemi basittir ancak görüntü kimlik sistemi anlayışını gerektirir. IronXL tek sayı dizisi (1, 3, 5, 7...) şeklinde kimlikleri atadığı için, birden fazla görüntüyü yönetirken bu kimlikleri takip edin. Uygulamanızda, daha kolay yönetim için anlamlı adları görüntü kimlikleri ile ilişkilendirmek amacıyla bir eşleme sistemi uygulamayı düşünün.

: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")

Birden çok çalışma sayfası ve görüntü içeren daha karmaşık senaryolar için, görüntü işlemlerinin çalışma sayfası düzeyindeki işlemlerle nasıl etkileşimde bulunduğunu anlamak için çalışma sayfalarını yönetme konusunu keşfedin. Ayrıca, korumalı Excel dosyalarıyla çalışırken, görüntü işlemlerinin şifre korumalı çalışma kitapları ile nasıl çalıştığını anlamak için Excel dosyalarını koruma konusundaki kılavuzumuza başvurun.