Datavalidering

Microsoft Excel erbjuder några bra funktioner för att filtrera automatiskt eller validera kalkylbladsdata. Aspose.Cells för Python via .NET stöder fullt ut Microsoft Excels datavalidering och AutoFilter-funktioner. Den här artikeln förklarar hur man använder funktionerna i Microsoft Excel och hur man kodar dem med hjälp av Aspose.Cells för Python via .NET.

Datavalideringstyper och utförande

Datavalidering är förmågan att ställa regler om data som skrivs in på ett arbetsblad. Använd till exempel validering för att säkerställa att en kolumn märkt DATUM endast innehåller datum, eller att en annan kolumn endast innehåller siffror. Du skulle även kunna säkerställa att en kolumn märkt DATUM endast innehåller datum inom ett visst intervall. Med datavalidering kan du kontrollera vad som skrivs in i celler på arbetsbladet.

Microsoft Excel stöder ett antal olika typer av datavalidering. Varje typ används för att styra vilken typ av data som skrivs in i en cell eller cellområde. Nedan illustrerar kodsnuttar hur man validerar att:

• Siffror är hela, det vill säga att de inte har en decimaldel.
• Decimaltal följer rätt struktur. Kodexemplet definierar att en rad celler ska ha två decimaler.
• Värden är begränsade till en lista med värden. Listvalidering definierar en separat lista med värden som kan tillämpas på en cell eller cellområde.
• Datum ligger inom ett specifikt intervall.
• En tid ligger inom ett specifikt intervall.
• En text är inom en given teckenlängd.

Datavalidering med Microsoft Excel

För att skapa valideringar med Microsoft Excel:

1. I ett kalkylblad, välj de celler till vilka du vill applicera validering.
2. Från menyn Data, välj Validering. Valideringsdialogen visas.
3. Klicka på fliken Inställningar och ange inställningar.

Datavalidering med Aspose.Cells för Python Excel-biblioteket

Datavalidering är en kraftfull funktion för att validera information som matas in i kalkylblad. Med datavalidering kan utvecklare tillhandahålla användare med en lista över val, begränsa datamatare till en specifik typ eller storlek, osv. I Aspose.Cells för Python via .NET har varje Worksheet klass en validations egenskap som representerar en samling av Validation objekt. För att ställa in validering, ställ in några av Validation klassens egenskaper enligt följande:

• typ - representerar valideringstypen, som kan specificeras genom att använda ett av de fördefinierade värdena i ValidationType -uppräkningen.
• Operator - representerar operatören som ska användas i valideringen, vilket kan specificeras genom att använda en av de fördefinierade värdena i OperatorType uppräkningen.
• formel1 - representerar värdet eller uttrycket som är associerat med den första delen av datavalideringen.
• formel2 - representerar värdet eller uttrycket associerat med den andra delen av datavalideringen.

När Validation objektets egenskaper har konfigurerats, kan utvecklare använda CellArea strukturen för att lagra information om cellområdet som kommer att valideras med den skapade valideringen.

Typer av Datavalidering

ValidationType uppräkning har följande medlemmar:

Medlemsnamn	Beskrivning
ANY_VALUE	Betecknar ett värde av vilken typ som helst.
WHOLE_NUMBER	Betecknar valideringstypen för heltal.
DECIMAL	Betecknar valideringstypen för decimaltal.
LIST	Betecknar valideringstypen för rullgardinsmeny.
DATE	Betecknar valideringstypen för datum.
TIME	Betecknar valideringstypen för tid.
TEXT_LENGTH	Betecknar valideringstypen för textlängd.
CUSTOM	Betecknar anpassad valideringstyp.

Heltalsdatavalidering

Med den här typen av validering kan användare endast ange heltal inom ett specificerat intervall i de validerade cellerna. Kodexemplen som följer visar hur man implementerar valideringstypen Heltal. Exemplet skapar samma datavalidering med Aspose.Cells för Python via .NET som vi skapade med Microsoft Excel ovan.

from aspose.cells import CellArea, OperatorType, ValidationType, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Create a workbook object.
workbook = Workbook()
#  Create a worksheet and get the first worksheet.
ExcelWorkSheet = workbook.worksheets[0]
#  Accessing the Validations collection of the worksheet
validations = workbook.worksheets[0].validations
#  Create Cell Area
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
#  Creating a Validation object
validation = validations[validations.add(ca)]
#  Setting the validation type to whole number
validation.type = ValidationType.WHOLE_NUMBER
#  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
area = CellArea()
area.start_row = 0
area.end_row = 1
area.start_column = 0
area.end_column = 1
#  Adding the cell area to Validation
validation.add_area(area)
#  Save the workbook.
workbook.save("output.out.xls")

Listvalidering

Denna typ av validering tillåter användaren att mata in värden från en nedrullningslista. Det tillhandahåller en lista: en serie rader som innehåller data. I exemplet läggs ett andra kalkylblad till för att hålla listkällan. Användare kan endast välja värden från listan. Valideringsområdet är cellområdet A1:A5 i det första kalkylbladet.

Det är viktigt här att du ställer in Validation.in_cell_drop_down egenskapen till true.

from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Create a workbook object.
workbook = Workbook()
#  Get the first worksheet.
worksheet1 = workbook.worksheets[0]
#  Add a new worksheet and access it.
i = workbook.worksheets.add()
worksheet2 = workbook.worksheets[i]
#  Create a range in the second worksheet.
range = worksheet2.cells.create_range("E1", "E4")
#  Name the range.
range.name = "MyRange"
#  Fill different cells with data in the range.
worksheet2.cells.get("E1").value = "Blue"
worksheet2.cells.get("E2").value = "Red"
worksheet2.cells.get("E3").value = "Green"
worksheet2.cells.get("E4").value = "Yellow"
#  Get the validations collection.
validations = worksheet1.validations
#  Create Cell Area
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
#  Create a new validation to the validations list.
validation = validations[validations.add(ca)]
#  Set the validation type.
validation.type = ValidationType.LIST
#  Set the operator.
validation.operator = OperatorType.NONE
#  Set the in cell drop down.
validation.in_cell_drop_down = True
#  Set the formula1.
validation.formula1 = "=MyRange"
#  Enable it to show error.
validation.show_error = True
#  Set the alert type severity level.
validation.alert_style = ValidationAlertType.STOP
#  Set the error title.
validation.error_title = "Error"
#  Set the error message.
validation.error_message = "Please select a color from the list"
#  Specify the validation area.
area = CellArea()
area.start_row = 0
area.end_row = 4
area.start_column = 0
area.end_column = 0
#  Add the validation area.
validation.add_area(area)
#  Save the Excel file.
workbook.save("output.out.xls")

Datumdata validering

Med denna typ av validering anger användare datumvärden inom ett angivet intervall eller enligt specifika kriterier i de validerade cellerna. I exemplet är användaren begränsad att ange datum mellan 1970 och 1999. Här är valideringsområdet cell B1.

from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Create a workbook.
workbook = Workbook()
#  Obtain the cells of the first worksheet.
cells = workbook.worksheets[0].cells
#  Put a string value into the A1 cell.
cells.get("A1").put_value("Please enter Date b/w 1/1/1970 and 12/31/1999")
#  Set row height and column width for the cells.
cells.set_row_height(0, float(31))
cells.set_column_width(0, float(35))
#  Get the validations collection.
validations = workbook.worksheets[0].validations
#  Create Cell Area
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
#  Add a new 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.show_error = True
#  Set the validation alert style.
validation.alert_style = ValidationAlertType.STOP
#  Set the title of the data-validation error dialog box
validation.error_title = "Date Error"
#  Set the data validation error message.
validation.error_message = "Enter a Valid Date"
#  Set and enable the data validation input message.
validation.input_message = "Date Validation Type"
validation.ignore_blank = True
validation.show_input = True
#  Set a collection of CellArea which contains the data validation settings.
cellArea = CellArea()
cellArea.start_row = 0
cellArea.end_row = 0
cellArea.start_column = 1
cellArea.end_column = 1
#  Add the validation area.
validation.add_area(cellArea)
#  Save the Excel file.
workbook.save("output.out.xls")

Tidsdata validering

Med denna typ av validering kan användare ange tider inom ett angivet intervall eller enligt vissa kriterier i de validerade cellerna. I exemplet är användaren begränsad att ange tider mellan 09:00 och 11:30 förmiddag. Här är valideringsområdet cell B1.

from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Create a workbook.
workbook = Workbook()
#  Obtain the cells of the first worksheet.
cells = workbook.worksheets[0].cells
#  Put a string value into A1 cell.
cells.get("A1").put_value("Please enter Time b/w 09:00 and 11:30 'o Clock")
#  Set the row height and column width for the cells.
cells.set_row_height(0, float(31))
cells.set_column_width(0, float(35))
#  Get the validations collection.
validations = workbook.worksheets[0].validations
#  Create Cell Area
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
#  Add a new 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.show_error = True
#  Set the validation alert style.
validation.alert_style = ValidationAlertType.INFORMATION
#  Set the title of the data-validation error dialog box.
validation.error_title = "Time Error"
#  Set the data validation error message.
validation.error_message = "Enter a Valid Time"
#  Set and enable the data validation input message.
validation.input_message = "Time Validation Type"
validation.ignore_blank = True
validation.show_input = True
#  Set a collection of CellArea which contains the data validation settings.
cellArea = CellArea()
cellArea.start_row = 0
cellArea.end_row = 0
cellArea.start_column = 1
cellArea.end_column = 1
#  Add the validation area.
validation.add_area(cellArea)
#  Save the Excel file.
workbook.save("output.out.xls")

Textlängd data validering

Med denna typ av validering kan användare ange textvärden av en angiven längd i de validerade cellerna. I exemplet är användaren begränsad att ange strängvärden med högst 5 tecken. Valideringsområdet är cell B1.

from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Create a new workbook.
workbook = Workbook()
#  Obtain the cells of the first worksheet.
cells = workbook.worksheets[0].cells
#  Put a string value into A1 cell.
cells.get("A1").put_value("Please enter a string not more than 5 chars")
#  Set row height and column width for the cell.
cells.set_row_height(0, float(31))
cells.set_column_width(0, float(35))
#  Get the validations collection.
validations = workbook.worksheets[0].validations
#  Create Cell Area
ca = CellArea()
ca.start_row = 0
ca.end_row = 0
ca.start_column = 0
ca.end_column = 0
#  Add a new validation.
validation = validations[validations.add(ca)]
#  Set the data validation type.
validation.type = ValidationType.TEXT_LENGTH
#  Set the operator for the data validation.
validation.operator = OperatorType.LESS_OR_EQUAL
#  Set the value or expression associated with the data validation.
validation.formula1 = "5"
#  Enable the error.
validation.show_error = True
#  Set the validation alert style.
validation.alert_style = ValidationAlertType.WARNING
#  Set the title of the data-validation error dialog box.
validation.error_title = "Text Length Error"
#  Set the data validation error message.
validation.error_message = " Enter a Valid String"
#  Set and enable the data validation input message.
validation.input_message = "TextLength Validation Type"
validation.ignore_blank = True
validation.show_input = True
#  Set a collection of CellArea which contains the data validation settings.
cellArea = CellArea()
cellArea.start_row = 0
cellArea.end_row = 0
cellArea.start_column = 1
cellArea.end_column = 1
#  Add the validation area.
validation.add_area(cellArea)
#  Save the Excel file.
workbook.save("output.out.xls")

Data valideringsregler

När datavalideringar är implementerade kan valideringen kontrolleras genom att tilldela olika värden i cellerna. Cell.get_validation_value() kan användas för att hämta valideringsresultatet. Följande exempel visar denna funktion med olika värden. Testfilen kan laddas ner från följande länk för testning:

sampleDataValidationRules.xlsx

from aspose.cells import Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  Instantiate the workbook from sample Excel file
workbook = Workbook("sample.xlsx")
#  Access the first 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 = worksheet.cells.get("C1")
#  Enter 3 inside this cell
#  Since it is not between 10 and 20, it should fail the validation
cell.put_value(3)
#  Check if number 3 satisfies the Data Validation rule applied on this cell
print("Is 3 a Valid Value for this Cell: "  + str(cell.get_validation_value()))
#  Enter 15 inside this cell
#  Since it is between 10 and 20, it should succeed the validation
cell.put_value(15)
#  Check if number 15 satisfies the Data Validation rule applied on this cell
print("Is 15 a Valid Value for this Cell: "  + str(cell.get_validation_value()))
#  Enter 30 inside this cell
#  Since it is not between 10 and 20, it should fail the validation again
cell.put_value(30)
#  Check if number 30 satisfies the Data Validation rule applied on this cell
print("Is 30 a Valid Value for this Cell: "  + str(cell.get_validation_value()))

Kontrollera om valideringen i cellen är rullgardinsmeny

Som vi har sett finns det många typer av valideringar som kan implementeras i en cell. Om du vill kontrollera om valideringen är en rullgardinsmeny eller inte, kan Validation.in_cell_drop_down-egenskapen användas för att testa detta. Följande kodexempel demonstrerar användningen av denna egenskap. En exempelfil för testning kan laddas ned från länken nedan:

sampleValidation.xlsx

from aspose.cells import Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
book = Workbook("sampleValidation.xlsx")
sheet = book.worksheets.get("Sheet1")
cells = sheet.cells
a2 = cells.get("A2")
va2 = a2.get_validation()
if va2.in_cell_drop_down:
    print("A2 is a dropdown")
else:
    print("A2 is NOT a dropdown")
b2 = cells.get("B2")
vb2 = b2.get_validation()
if vb2.in_cell_drop_down:
    print("B2 is a dropdown")
else:
    print("B2 is NOT a dropdown")
c2 = cells.get("C2")
vc2 = c2.get_validation()
if vc2.in_cell_drop_down:
    print("C2 is a dropdown")
else:
    print("C2 is NOT a dropdown")

Lägg till CellArea till befintlig validering

Det kan finnas fall där du vill lägga till CellArea till befintlig Validation. När du lägger till CellArea med hjälp av Validation.add_area(cell_area), kontrollerar Aspose.Cells alla befintliga områden för att se om det nya området redan finns. Om filen har många valideringar påverkar detta prestandan. För att komma runt detta tillhandahåller API:et metoden Validation.add_area(cell_area, check_intersection, check_edge). Parametern checkIntersection indikerar om det ska kontrolleras om det nya området korsar andra valideringsområden. Om den sätts till false inaktiveras kontrollen av andra områden. Parametern checkEdge indikerar om de tillämpade områdena ska kontrolleras. Om det nya området blir det översta vänstra området byggs interna inställningar om. Om du är säker på att det nya området inte är det översta vänstra området kan du ställa in denna parameter som false.

Följande kodsnutt demonstrerar användningen av Validation.add_area(cell_area, check_intersection, check_edge)-metoden för att lägga till ny CellArea till befintlig Validation.

from aspose.cells import CellArea, Workbook

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
workbook = Workbook("ValidationsSample.xlsx")
#  Access first worksheet.
worksheet = workbook.worksheets[0]
#  Accessing the Validations collection of the worksheet
validation = worksheet.validations[0]
#  Create your cell area.
cellArea = CellArea.create_cell_area("D5", "E7")
#  Adding the cell area to Validation
validation.add_area(cellArea, False, False)
#  Save the output workbook.
workbook.save("ValidationsSample_out.xlsx")

Käll- och utdataexcelfilerna är bilagda som referens.

Källfil

Utdatafil

Fortsatta ämnen

• Hämta cellvalidering i ODS-filer
• Få validering som tillämpas på en cell
• Verifiera att cellvärdet uppfyller datavalideringsreglerna