Excel'de C# Kullanarak Veri Doğrulama

Excel’de veri doğrulama, kullanıcıların çalışma sayfalarına yalnızca geçerli veriler girmesini sağlar. Form tasarlarken, veri toplarken veya finansal modeller oluştururken, veri doğrulamaları yapıyı korumaya ve kullanıcı hatalarını en aza indirmeye yardımcı olur. Bu yazıda, Excel’de veri doğrulamayı C# kullanarak programlı bir şekilde nasıl uygulayacağınızı göstereceğiz.

Bu makale aşağıdaki konuları kapsamaktadır:

C# Excel Veri Doğrulama Kütüphanesi

Veri doğrulama, kullanıcıların Excel elektronik tablolarına geçerli ve beklenen girdi girmesini sağlar. Excel’de farklı veri doğrulama türleri eklemek için Aspose.Cells for .NET API’sini kullanacağız. Bu, bağlam listeleri, sayısal aralıklar, tarih sınırlamaları ve özel formüller gibi kuralları tanımlamak için güçlü ve esnek bir yaklaşım sunar; tüm bunlar Microsoft Excel’e ihtiyaç duymadan.

Aspose.Cells for .NET paketini projenize NuGet aracılığıyla kurun:

PM> Install-Package Aspose.Cells

Sonra ilgili ad alanını içe aktarın:

using Aspose.Cells;

Dropdown List Doğrulaması Oluşturma Excel’de C# Kullanarak

Kullanıcı girişini önceden tanımlanmış bir seçenekler setiyle sınırlamak için Excel’de bir açılır liste doğrulaması oluşturabilirsiniz. Bu, formlar veya şablonlarda özellikle yararlı olan tutarlı değerler sağlar.

Bu adımları izleyerek C# kullanarak Excel`de bir açılır liste oluşturun:

  1. Yeni bir Workbook nesnesi oluşturun.
  2. İndeksini kullanarak ilk worksheet‘e erişin.
  3. Hedef CellArea doğrulama için tanımlayın.
  4. Worksheet’in Validations koleksiyonuna erişin.
  5. Yeni bir doğrulama eklemek için Add() yöntemini kullanın.
  6. Doğrulama türünü ValidationType.List olarak ayarlayın.
  7. Dropdown seçeneklerini Formula1 özelliğini kullanarak tanımlayın (virgülle ayrılmış).
  8. Hücre alanını AddArea() yöntemini kullanarak doğrulamaya ekleyin.
  9. Workbook’u kaydedin, onaylanmış Excel dosyasını oluşturmak için.

İşte bu adımları uygulayan C# kod örneği:

// Yeni bir Excel çalışma kitabı oluşturun
var workbook = new Workbook();

// Çalışma kitabındaki ilk sayfaya erişin
var sheet = workbook.Worksheets[0];

// Hedef hücre alanını doğrulamayı tanımlayın (bu durumda A1)
var area = new CellArea
{
    StartRow = 0,     // Row index starts from 0 (Row 1)
    EndRow = 0,       // Apply to a single row
    StartColumn = 0,  // Column index starts from 0 (Column A)
    EndColumn = 0     // Apply to a single column
};

// Çalışma sayfasının doğrulama koleksiyonuna erişin
var validations = sheet.Validations;

// Yeni bir doğrulama girişi ekleyin belirtilen hücre alanı için.
int index = validations.Add(area);
var validation = validations[index];

// Doğrulama türünü bir açılır listeye ayarlayın.
validation.Type = ValidationType.List;

// Tanımlanan izin verilen liste elemanları (virgülle ayrılmış değerler)
validation.Formula1 = "Red,Green,Blue";

// Seçilen hücrede gösterilecek giriş mesajını ayarlayın.
validation.InputMessage = "Select a color from the list.";

// Geçersiz veri girildiğinde gösterilecek hata mesajını ayarlayın.
validation.ErrorMessage = "Only Red, Green, or Blue are allowed.";

// Hata mesajının görüntülenmesini etkinleştir.
validation.ShowError = true;

// Tanımlı alanı doğrulamaya uygulayın.
validation.AddArea(area);

// Çalışma kitabını belirtilen dosya yoluna kaydedin.
workbook.Save("dropdown-validation.xlsx");
Excel'de C# Kullanarak Aşağı Açılır Liste Doğrulaması Oluşturma

Excel’de C# Kullanarak Açılır Liste Doğrulama Oluşturma

Excel’de C# kullanarak Tam Sayılara Sınırlama

Tam sayı doğrulaması, kullanıcıların Excel’de yalnızca geçerli tam sayıları girmesini sağlar, bu da ondalık veya metinlerin kabul edilmediği miktar alanları, yaş girdileri veya bütçe tabloları için idealdir.

Bir hücrenin yalnızca 1 ile 100 arasındaki sayıları kabul etmesini sağlamak istediğinizi varsayalım. Bu kural olmadan, kullanıcılar yanlışlıkla 150 veya abc gibi geçersiz girişler yapabilir, bu da hesaplama hatalarına veya elektronik tablonuzda mantık sorunlarına neden olabilir.

Aspose.Cells for .NET ile, bu doğrulama kuralını C# ile programatik olarak uygulayabilir ve Excel’de manuel olarak yapılandırmanıza gerek kalmaz.

Aşağıdaki kod kesiti, kullanıcıların yalnızca izin verilen değerleri girmesini nasıl kısıtlayacağını göstermektedir:

using Aspose.Cells;

// Yeni bir Excel çalışma kitabı oluşturun
var workbook = new Workbook();

// Workbook'taki ilk çalışma sayfasına erişin
var sheet = workbook.Worksheets[0];

// Hedef hücre alanını tanımlayın — B2 (1. satır, 1. sütun)
var area = new CellArea
{
    StartRow = 1,
    EndRow = 1,
    StartColumn = 1,
    EndColumn = 1
};

// Çalışma sayfasının doğrulama koleksiyonuna erişin
var validations = sheet.Validations;

// Yeni bir doğrulama ekleyin ve indeksini alın.
int index = validations.Add(area);

// Geçerlilik nesnesini indeks kullanarak al.
var validation = validations[index];

// Doğrulama türünü TamSayı olarak ayarlayın (sadece tamsayılar izinlidir)
validation.Type = ValidationType.WholeNumber;

// Operatörü "Arasında" olarak ayarlayın.
validation.Operator = OperatorType.Between;

// Geçerli aralığı tanımlayın: 1 ile 100 arası
validation.Formula1 = "1";
validation.Formula2 = "100";

// Geçersiz veri girildiğinde görüntülenen hata mesajını ayarlayın.
validation.ErrorMessage = "Enter a number between 1 and 100.";

// Hata uyarısının doğrulama başarısız olduğunda gösterilmesini sağlayın.
validation.ShowError = true;

// (Optional if not using Add(area) earlier) Alanı doğrulamaya açıkça ekleyin
validation.AddArea(area);

// Çalışma kitabını bir dosyaya kaydedin.
workbook.Save("numbers-validation.xlsx");
Excel'de C# kullanarak Tam Sayıları Kısıtlama

Excel’de C# kullanarak Tam Sayıları Kısıtlama

Excel`de Tarih Aralığı Doğrulaması Uygulama C# kullanarak

Tarih doğrulama, kullanıcıların yalnızca geçerli tarihler girmesini sağlamaya yardımcı olur. Planlama araçlarında, katılım kayıtlarında, rezervasyon cetvellerinde ve belirli bir tarih aralığında tarihlere ihtiyaç duyduğunuz her senaryoda yararlıdır.

Örneğin, bir proje programlama şablonu oluşturduğunuzu hayal edin ve kullanıcıların sadece 2024 yılı içinde tarihler girmesini kısıtlamak istiyorsunuz. Kullanıcıların bu aralığın dışındaki bir tarihi girmesine izin vermek (örneğin 2023 veya 2025) formüllerin bozulmasına veya tutarsız kayıtların oluşmasına neden olabilir.

Aspose.Cells for .NET, belirli hücrelere tarih doğrulamaları uygulamayı kolaylaştırır, böylece kullanıcılar yalnızca sizin kriterlerinize uyan tarihleri girebilirler.

Aşağıdaki kod parçacığı, kullanıcıların yalnızca 1 Ocak 2024 ile 31 Aralık 2024 tarihleri arasında tarih girmesini sağlamanın nasıl yapılacağını göstermektedir. Aralığın dışındaki herhangi bir şey bir hata tetikleyecek, böylece elektronik tablonuzda daha temiz ve daha doğru veriler tutmanıza yardımcı olacaktır.

using Aspose.Cells;

// Yeni bir Excel çalışma kitabı oluşturun.
var workbook = new Workbook();

// Çalışma kitabındaki ilk çalışma sayfasına erişin
var sheet = workbook.Worksheets[0];

// Geçerlilik uygulamak için hücre alanını tanımlayın — C3 (satır 2, sütun 2)
var area = new CellArea
{
    StartRow = 2,
    EndRow = 2,
    StartColumn = 2,
    EndColumn = 2
};

// Çalışma sayısının doğrulamalar koleksiyonuna erişin.
var validations = sheet.Validations;

// Yeni bir doğrulama ekleyin ve indeksini alın.
int index = validations.Add(area);

// Validation nesnesini al
var validation = validations[index];

// Tarih doğrulama türünü ayarlayın
validation.Type = ValidationType.Date;

// Operatörü Arasında (başlangıç ve bitiş tarihleri) olarak ayarlayın.
validation.Operator = OperatorType.Between;

// Geçerli tarih aralığını belirtin: 1 Ocak 2024 - 31 Aralık 2024
validation.Formula1 = "2024-01-01";
validation.Formula2 = "2024-12-31";

// Tarih aralığı dışındaysa görüntülenecek hata mesajını ayarlayın
validation.ErrorMessage = "Date must be within the year 2024.";

// Hata uyarısını gösterme özelliğini etkinleştir
validation.ShowError = true;

// Alanı yeniden uygulayın, böylece doğrulamanın doğru bir şekilde bağlandığından emin olun.
validation.AddArea(area);

// Belirtilen yola çalışma kitabını kaydedin.
workbook.Save("date-validation.xlsx");

Excel’de C# Kullanarak Formül Tabanlı Doğrulama Kullanın

Bazen, basit açılır menüler veya sabit sayı aralıkları yeterli olmayabilir, özellikle kurallarınız diğer hücrelerdeki değerlere bağlı olduğunda. Formül tabanlı doğrulama ile, Excel tarzı formüller kullanarak özel kurallar tanımlayabilirsiniz. Bu kurallar, diğer hücrelere atıfta bulunabilir ve girdinin geçerli olup olmadığını dinamik olarak değerlendirebilir. Örneğin, B1 hücresindeki değerin her zaman A1 hücresindeki değerden büyük olmasını sağlamak isteyebilirsiniz. Bu, fiyat karşılaştırmaları, puanlama tabloları veya tarih dizileri için yaygın bir senaryodur.

Aspose.Cells for .NET bu özelliği tamamen destekler ve Excel’de olduğu gibi özel formüller kullanarak doğrulama tanımlamanıza olanak tanır.

Aşağıdaki kod örneği, C# kullanarak Excel’de formül tabanlı doğrulamaların nasıl uygulanacağını göstermektedir.

using Aspose.Cells;

// Yeni bir Excel çalışma kitabı oluşturun
var workbook = new Workbook();

// Çalışma kitabındaki ilk çalışma sayfasına erişin
var sheet = workbook.Worksheets[0];

// Hücre alanını doğrulama için tanımlayın — B1 (satır 0, sütun 1)
var area = new CellArea
{
    StartRow = 0,
    EndRow = 0,
    StartColumn = 1,
    EndColumn = 1
};

// Çalışma sayfaları doğrulamaları koleksiyonuna erişin
var validations = sheet.Validations;

// Koleksiyona yeni bir doğrulama ekleyin ve indeksini alın.
int index = validations.Add(area);

// İndex ile doğrulama nesnesini al.
var validation = validations[index];

// Geçerlilik türünü Özel olarak ayarlayın (formül tabanlı kurallar için kullanılır)
validation.Type = ValidationType.Custom;

// Özel formülü ayarlayın: B1, A1'den büyük olmalıdır.
validation.Formula1 = "=B1>A1";

// Doğrulama başarısız olduğunda gösterilen hata mesajını tanımlayın.
validation.ErrorMessage = "Value in B1 must be greater than A1.";

// Geçersiz girdi için hata uyarısının görüntülenmesini etkinleştir.
validation.ShowError = true;

// Alanı açıkça ekleyin, böylece doğrulamanın kapsamına girdiğinden emin olun.
validation.AddArea(area);

// Çalışma kitabını belirtilen dosya yoluna kaydedin.
workbook.Save("formula-validation.xlsx");

Excel’de Giriş ve Hata Mesajlarını C# Kullanarak Yapılandırma

Veri doğrulama uygulamak, çözümün sadece bir parçasıdır. Kullanıcıları yanlış veri girdiklerinde yönlendirmek de aynı derecede önemlidir ve burada özel uyarılar ve mesajlar önemli bir rol oynar.

Aspose.Cells for .NET, kullanıcıların bir hücreyi seçtiğinde veya geçersiz veri girdiğinde görünen yararlı giriş mesajları ve hata uyarıları kurmanıza olanak tanır. Bu mesajlar kullanıcı deneyimini artırır, kafa karışıklığını azaltır ve Excel şablonlarınızı daha profesyonel hale getirir.

Örneğin, bir kullanıcı bir hücreye tıkladığında, aşağıdaki gibi bir ipucu gösterebilirsiniz.

“Sadece 1 ile 100 arasında değerler kabul edilir.”

Ve yanlış bir değer girerlerse, Excel şu mesajı gösteren bir diyalog kutusu açabilir:

`Geçersiz Giriş: Lütfen 1 ile 100 arasında bir sayı girin.”

Geçersiz girdiye Excel’in nasıl yanıt vereceğini özelleştirmek için, kullanıcıyı tamamen engellemeyi (Stop), uyarıyla devam etmelerine izin vermeyi (Warning) veya yalnızca bilgilendirici bir mesaj göstermeyi (Information) seçebilirsiniz.

Bu adımları takip ederek C# kullanarak doğrulama uyarılarını yapılandırın:

  1. Doğrulama kuralını ayarladıktan sonra, bir kullanıcı hücreyi seçtiğinde yardım metnini göstermek için InputTitle ve InputMessage değerlerini ayarlayın.
  2. ErrorTitle ve ErrorMessage‘i tanımlayın, eğer doğrulama başarısız olursa neyin yanlış olduğunu açıklamak için.
  3. Bir AlertStyle seçin — seçenekler arasında Stop, Warning ve Information bulunmaktadır.
  4. ShowError değerini true olarak ayarlayın, böylece doğrulama uyarısını etkinleştirin.
  5. Çalışma kitabını kaydedin.

Bu uyarılar, özellikle başkalarının sıkça kullanması veya yeniden kullanması için şablonlar oluşturduğunuzda, elektronik tablonuzu daha sezgisel ve kullanıcı dostu hale getirir.

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

// Doğrulama alanını ayarlayın — C1 hücresine uygulayın
var area = new CellArea
{
    StartRow = 0,
    EndRow = 0,
    StartColumn = 2, // Column C = 2
    EndColumn = 2
};

// Validation ekleyin
int index = sheet.Validations.Add(area);
var validation = sheet.Validations[index];

validation.Type = ValidationType.Custom;

// Bu formül her zaman FALSE olarak değerlendirilir.
validation.Formula1 = "=FALSE";

// Set up input and error messages
validation.InputTitle = "Input Restricted";
validation.InputMessage = "Try entering anything to see the validation.";
validation.ErrorTitle = "Invalid Input";
validation.ErrorMessage = "You triggered this validation error successfully!";
validation.AlertStyle = ValidationAlertType.Stop;
validation.ShowError = true;
validation.ShowInput = true;

// Alan üzerinde doğrulama uygulayın.
validation.AddArea(area);

// Geçerli çalışma kitabını kaydedin.
workbook.Save("D:\\Files\\validated_with_alerts.xlsx");

Uyarılar, kullanılabilirliği artırır ve kullanıcılara ne girmeleri gerektiği konusunda açık bir rehberlik sağlar.

Excel'de Girdi ve Hata Mesajlarını C# Kullanarak Yapılandırma

Excel’de Giriş ve Hata Mesajlarını C# Kullanarak Yapılandırma

Ücretsiz Deneyin

Aspose.Cells for .NET’in tüm yeteneklerini herhangi bir özellik sınırı olmadan test etmek için bir ücretsiz geçici lisans alın.

Ücretsiz Kaynaklar

Excel otomasyonu ve doğrulaması hakkında daha fazla bilgi edinmek için bu kaynakları keşfedin:

Sonuç

Bu makalede, C# kullanarak Aspose.Cells for .NET ile Excel’de veri doğrulamanın nasıl uygulanacağını gösterdik. Aşağı açılır menülerden özel formüllere kadar, Excel’e bağımlı olmadan akıllı ve hatasız tablolar oluşturabilirsiniz.

Eğer herhangi bir sorunuz veya geri bildiriminiz varsa, lütfen bunları free support forum üzerinde paylaşmaktan çekinmeyin. Size yardımcı olmaktan mutluluk duyarız!

See Also