Veri doğrulama

Microsoft Excel, çalışma sayfası verilerini otomatik olarak filtrelemek veya doğrulamak için bazı iyi özellikler sağlar. Aspose.Cells, Microsoft Excel’in veri doğrulama ve Otomatik Filtre özelliklerini tam olarak destekler. Bu makalede, Microsoft Excel’deki özelliklerin nasıl kullanılacağı ve bunların Aspose.Cells kullanılarak nasıl kodlanacağı açıklanmaktadır.

Veri Doğrulama Türleri ve Yürütme

Veri doğrulama, bir çalışma sayfasına girilen verilerle ilgili kuralları belirleme yeteneğidir. Örneğin, TARİH etiketli bir sütunun yalnızca tarihleri veya başka bir sütunun yalnızca sayıları içerdiğinden emin olmak için doğrulamayı kullanın. TARİH etiketli bir sütunun yalnızca belirli bir aralıktaki tarihleri içermesini bile sağlayabilirsiniz. Veri doğrulama ile çalışma sayfasındaki hücrelere nelerin girildiğini kontrol edebilirsiniz.

Microsoft Excel, bir dizi farklı veri doğrulama türünü destekler. Her tür, bir hücreye veya hücre aralığına ne tür verilerin girildiğini kontrol etmek için kullanılır. Aşağıda, kod parçacıkları şunun nasıl doğrulanacağını göstermektedir:

• Numbers tamdır, yani ondalık kısmı yoktur.
• Ondalık sayılar doğru yapıyı takip eder. Kod örneği, bir hücre aralığının iki ondalık boşluğa sahip olması gerektiğini tanımlar.
• Değerler, bir değerler listesiyle sınırlıdır. Liste doğrulama, bir hücreye veya hücre aralığına uygulanabilen ayrı bir değer listesi tanımlar.
• Tarihler belirli bir aralığa giriyor.
• Bir zaman belirli bir aralıktadır.
• Bir metin belirli bir karakter uzunluğundadır.

Microsoft Excel ile Veri Doğrulama

Microsoft Excel’i kullanarak doğrulama oluşturmak için:

1. Bir çalışma sayfasında doğrulama uygulamak istediğiniz hücreleri seçin.
2. itibarenVeri menü, seçDoğrulama. Doğrulama iletişim kutusu görüntülenecektir.
3. TıklaAyarlar sekmesine gidin ve ayarlara girin.

Aspose.Cells ile Veri Doğrulama

Veri doğrulama, çalışma sayfalarına girilen bilgileri doğrulamak için güçlü bir özelliktir. Veri doğrulama ile geliştiriciler, kullanıcılara bir seçenek listesi sağlayabilir, veri girişlerini belirli bir tür veya boyutla kısıtlayabilir, vb. Aspose.Cells’de, her biriÇalışma kağıdı sınıfın birDoğrulamalarkoleksiyonunu temsil eden özellikDoğrulama nesneler. Doğrulamayı ayarlamak için bazılarını ayarlayın.Doğrulamasınıfın özellikleri aşağıdaki gibidir:

• Tür – önceden tanımlanmış değerlerden biri kullanılarak belirtilebilen doğrulama türünü temsil eder.Doğrulama Türünumaralandırma.
• Operatör – doğrulamada kullanılacak olan ve önceden tanımlanmış değerlerden biri kullanılarak belirtilebilen operatörü temsil eder.OperatörTürünumaralandırma.
• Formül1 – veri doğrulamanın ilk kısmıyla ilişkili değeri veya ifadeyi temsil eder.
• Formül2 – veri doğrulamanın ikinci kısmıyla ilişkili değeri veya ifadeyi temsil eder.

Ne zamanDoğrulama nesnenin özellikleri yapılandırıldı, geliştiricilerhücre alanıoluşturulan doğrulama kullanılarak doğrulanacak hücre aralığı hakkında bilgi depolamak için yapı.

Veri Doğrulama Türleri

buDoğrulama Türünumaralandırma aşağıdaki üyelere sahiptir:

Üye adı	Açıklama
Herhangi bir değer	Herhangi bir türden bir değeri belirtir.
Bütün sayı	Tam sayılar için doğrulama türünü belirtir.
Ondalık	Ondalık sayılar için doğrulama türünü belirtir.
Liste	Açılır liste için doğrulama türünü belirtir.
Tarih	Tarihler için doğrulama türünü belirtir.
Zaman	Zaman için doğrulama türünü belirtir.
Metin Uzunluğu	Metnin uzunluğu için doğrulama türünü belirtir.
Gelenek	Özel doğrulama türünü belirtir.

Tam Sayı Veri Doğrulaması

Bu doğrulama türünde, kullanıcılar doğrulanmış hücrelere yalnızca belirli bir aralıktaki tam sayıları girebilir. Aşağıdaki kod örnekleri, WholeNumber doğrulama türünün nasıl uygulanacağını gösterir. Örnek, yukarıda Microsoft Excel kullanarak oluşturduğumuz aynı veri doğrulamasını Aspose.Cells kullanarak oluşturur.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook object.
Workbook workbook = new Workbook();

// Create a worksheet and get the first worksheet.
Worksheet ExcelWorkSheet = workbook.Worksheets[0];

// Accessing the Validations collection of the worksheet
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Creating a Validation object
Validation validation = validations[validations.Add(ca)];

// Setting the validation type to whole number
validation.Type = ValidationType.WholeNumber;

// Setting the operator for validation to Between
validation.Operator = OperatorType.Between;

// Setting the minimum value for the validation
validation.Formula1 = "10";

// Setting the maximum value for the validation
validation.Formula2 = "1000";

// Applying the validation to a range of cells from A1 to B2 using the
// CellArea structure
CellArea area;
area.StartRow = 0;
area.EndRow = 1;
area.StartColumn = 0;
area.EndColumn = 1;

// Adding the cell area to Validation
validation.AddArea(area);


// Save the workbook.
workbook.Save(dataDir + "output.out.xls");

Liste Veri Doğrulaması

Bu doğrulama türü, kullanıcının bir açılır listeden değerler girmesine izin verir. Bir liste sağlar: veri içeren bir dizi satır. Örnekte, liste kaynağını tutmak için ikinci bir çalışma sayfası eklenmiştir. Kullanıcılar yalnızca listeden değer seçebilir. Doğrulama alanı, ilk çalışma sayfasındaki A1:A5 hücre aralığıdır.

ayarını yapmanız burada önemlidir.Validation.InCellDropDown mülkiyetdoğru.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook object.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet worksheet1 = workbook.Worksheets[0];

// Add a new worksheet and access it.
int i = workbook.Worksheets.Add();
Worksheet worksheet2 = workbook.Worksheets[i];

// Create a range in the second worksheet.
Range range = worksheet2.Cells.CreateRange("E1", "E4");

// Name the range.
range.Name = "MyRange";

// Fill different cells with data in the range.
range[0, 0].PutValue("Blue");
range[1, 0].PutValue("Red");
range[2, 0].PutValue("Green");
range[3, 0].PutValue("Yellow");

// Get the validations collection.
ValidationCollection validations = worksheet1.Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Create a new validation to the validations list.
Validation validation = validations[validations.Add(ca)];

// Set the validation type.
validation.Type = Aspose.Cells.ValidationType.List;

// Set the operator.
validation.Operator = OperatorType.None;

// Set the in cell drop down.
validation.InCellDropDown = true;

// Set the formula1.
validation.Formula1 = "=MyRange";

// Enable it to show error.
validation.ShowError = true;

// Set the alert type severity level.
validation.AlertStyle = ValidationAlertType.Stop;

// Set the error title.
validation.ErrorTitle = "Error";

// Set the error message.
validation.ErrorMessage = "Please select a color from the list";

// Specify the validation area.
CellArea area;
area.StartRow = 0;
area.EndRow = 4;
area.StartColumn = 0;
area.EndColumn = 0;

// Add the validation area.
validation.AddArea(area);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

Tarih Veri Doğrulaması

Bu tür bir doğrulama ile kullanıcılar, doğrulanmış hücrelere belirli bir aralıktaki veya belirli ölçütleri karşılayan tarih değerlerini girer. Örnekte, kullanıcı 1970 ile 1999 yılları arasında tarih girmekle sınırlandırılmıştır. Burada doğrulama alanı B1 hücresidir.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into the A1 cell.
cells["A1"].PutValue("Please enter Date b/w 1/1/1970 and 12/31/1999");

// Set row height and column width for the cells.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.Date;

// Set the operator for the data validation
validation.Operator = OperatorType.Between;

// Set the value or expression associated with the data validation.
validation.Formula1 = "1/1/1970";

// The value or expression associated with the second part of the data validation.
validation.Formula2 = "12/31/1999";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Stop;

// Set the title of the data-validation error dialog box
validation.ErrorTitle = "Date Error";

// Set the data validation error message.
validation.ErrorMessage = "Enter a Valid Date";

// Set and enable the data validation input message.
validation.InputMessage = "Date Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

Zaman Verisi Doğrulama

Bu tür bir doğrulama ile kullanıcılar, doğrulanmış hücrelere belirli bir aralıktaki veya bazı ölçütleri karşılayan zamanlar girebilir. Örnekte, kullanıcı 09:00 ile 11:30 AM arasındaki saatleri girmekle sınırlandırılmıştır. Burada doğrulama alanı B1 hücresidir.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into A1 cell.
cells["A1"].PutValue("Please enter Time b/w 09:00 and 11:30 'o Clock");


// Set the row height and column width for the cells.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.Time;

// Set the operator for the data validation.
validation.Operator = OperatorType.Between;

// Set the value or expression associated with the data validation.
validation.Formula1 = "09:00";

// The value or expression associated with the second part of the data validation.
validation.Formula2 = "11:30";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Information;

// Set the title of the data-validation error dialog box.
validation.ErrorTitle = "Time Error";

// Set the data validation error message.
validation.ErrorMessage = "Enter a Valid Time";

// Set and enable the data validation input message.
validation.InputMessage = "Time Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

Metin Uzunluğu Veri Doğrulaması

Bu tür bir doğrulama ile kullanıcılar, doğrulanan hücrelere belirli bir uzunluktaki metin değerlerini girebilirler. Örnekte, kullanıcının en fazla 5 karakter içeren dize değerleri girmesi kısıtlanmıştır. Doğrulama alanı B1 hücresidir.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

  // Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a new workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into A1 cell.
cells["A1"].PutValue("Please enter a string not more than 5 chars");


// Set row height and column width for the cell.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.TextLength;

// Set the operator for the data validation.
validation.Operator = OperatorType.LessOrEqual;

// Set the value or expression associated with the data validation.
validation.Formula1 = "5";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Warning;

// Set the title of the data-validation error dialog box.
validation.ErrorTitle = "Text Length Error";

// Set the data validation error message.
validation.ErrorMessage = " Enter a Valid String";

// Set and enable the data validation input message.
validation.InputMessage = "TextLength Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

Veri Doğrulama Kuralları

Veri doğrulamaları uygulandığında, hücrelere farklı değerler atanarak doğrulama kontrol edilebilir.Cell.GetValidationValue doğrulama sonucunu almak için kullanılabilir. Aşağıdaki örnek, bu özelliği farklı değerlerle göstermektedir. Örnek dosya, test için aşağıdaki bağlantıdan indirilebilir:

sampleDataValidationRules.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate the workbook from sample Excel file
Workbook workbook = new Workbook(dataDir+ "sample.xlsx");

// Access the first worksheet
Worksheet worksheet = workbook.Worksheets[0];

// Access Cell C1
// Cell C1 has the Decimal Validation applied on it.
// It can take only the values Between 10 and 20
Cell cell = worksheet.Cells["C1"];

// Enter 3 inside this cell
// Since it is not between 10 and 20, it should fail the validation
cell.PutValue(3);

// Check if number 3 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 3 a Valid Value for this Cell: " + cell.GetValidationValue());

// Enter 15 inside this cell
// Since it is between 10 and 20, it should succeed the validation
cell.PutValue(15);

// Check if number 15 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 15 a Valid Value for this Cell: " + cell.GetValidationValue());

// Enter 30 inside this cell
// Since it is not between 10 and 20, it should fail the validation again
cell.PutValue(30);

// Check if number 30 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 30 a Valid Value for this Cell: " + cell.GetValidationValue());

Hücredeki doğrulamanın açılır olup olmadığını kontrol edin

Gördüğümüz gibi, bir hücre içinde uygulanabilecek birçok doğrulama türü vardır. Doğrulamanın açılır olup olmadığını kontrol etmek istiyorsanız,Validation.InCellDropDown özelliği bunu test etmek için kullanılabilir. Aşağıdaki örnek kod, bu özelliğin kullanımını gösterir. Test için örnek bir dosya aşağıdaki bağlantıdan indirilebilir:

sampleValidation.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
Workbook book = new Workbook(sourceDir + "sampleValidation.xlsx");
Worksheet sheet = book.Worksheets["Sheet1"];
Cells cells = sheet.Cells;
Cell a2 = cells["A2"];
Validation va2 = a2.GetValidation();
if (va2.InCellDropDown)
{
    Console.WriteLine("A2 is a dropdown");
}
else
{
    Console.WriteLine("A2 is NOT a dropdown");
}
Cell b2 = cells["B2"];
Validation vb2 = b2.GetValidation();
if (vb2.InCellDropDown)
{
    Console.WriteLine("B2 is a dropdown");
}
else
{
    Console.WriteLine("B2 is NOT a dropdown");
}
Cell c2 = cells["C2"];
Validation vc2 = c2.GetValidation();
if (vc2.InCellDropDown)
{
    Console.WriteLine("C2 is a dropdown");
}
else
{
    Console.WriteLine("C2 is NOT a dropdown");
}

CellArea’yı mevcut Doğrulamaya ekleyin

Eklemek isteyebileceğiniz durumlar olabilir.hücre alanımevcutDoğrulama. eklediğinizdehücre alanı kullanarakValidation.AddArea(CellArea cellArea), Aspose.Cells, yeni alanın zaten var olup olmadığını görmek için tüm mevcut alanları kontrol eder. Dosyada çok sayıda doğrulama varsa, bu bir performans isabeti alır. Bunun üstesinden gelmek için API,Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) yöntem. bucheckKavşak parametresi, belirli bir alanın mevcut doğrulama alanlarıyla kesişiminin kontrol edilip edilmeyeceğini belirtir. ayarlanıyorYANLIŞ diğer alanların kontrolünü devre dışı bırakacaktır. bucheckEdge parametre uygulanan alanların kontrol edilip edilmeyeceğini belirtir. Yeni alan sol üst alan olursa dahili ayarlar yeniden oluşturulur. Yeni alanın sol üst alan olmadığından eminseniz bu parametreyi şu şekilde ayarlayabilirsiniz:YANLIŞ.

Aşağıdaki kod parçacığı,Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) yeni ekleme yöntemihücre alanımevcutDoğrulama.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// directories
string SourceDir = RunExamples.Get_SourceDirectory();
string outputDir = RunExamples.Get_OutputDirectory();

Workbook workbook = new Workbook(SourceDir + "ValidationsSample.xlsx");

// Access first worksheet.
Worksheet worksheet = workbook.Worksheets[0];

// Accessing the Validations collection of the worksheet
Validation validation = worksheet.Validations[0];

// Create your cell area.
CellArea cellArea = CellArea.CreateCellArea("D5", "E7");

// Adding the cell area to Validation
validation.AddArea(cellArea, false, false);

// Save the output workbook.
workbook.Save(outputDir + "ValidationsSample_out.xlsx");

Kaynak ve çıktı excel dosyaları referans için eklenmiştir.

Kaynak dosyası

Çıktı dosyası

ileri konular

• ODS Dosyalarında Cell Doğrulaması Alın
• Cell’de Doğrulama Uygulayın
• Cell Değerinin Veri Doğrulama Kurallarını Karşıladığını Doğrulayın