Datavalidering
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:
- I ett kalkylblad, välj de celler till vilka du vill applicera validering.
- Från menyn Data, välj Validering. Valideringsdialogen visas.
- Klicka på fliken Inställningar och ange inställningar.
Datavalidering med Aspose.Cells for Node.js via C++
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 for Node.js via C++ har varje Worksheet klass en getValidations() metod som representerar en samling av Validation objekt. För att ställa in valideringen, ställ in några av egenskaperna hos klassen Validation enligt följande:
- Typ – representerar valideringstypen, som kan specificeras genom att använda ett av de fördefinierade värdena i enum ValidationType.
- Operator – representerar operatorn som ska användas i valideringen, som kan specificeras genom att använda ett av de fördefinierade värdena i enum OperatorType.
- Formel1 - representerar värdet eller uttrycket associerat med den första delen av datavalideringen.
- Formel2 - representerar värdet eller uttrycket associerat med den andra delen av datavalideringen.
När egenskaperna för Validation objektet har konfigurerats, kan utvecklare använda strukturen CellArea för att lagra information om cellområdet som ska valideras med hjälp av den skapade valideringen.
Typer av Datavalidering
Enum ValidationType har följande medlemmar:
| Medlemsnamn | Beskrivning |
|---|---|
| AnyValue | Betecknar ett värde av valfri typ. |
| WholeNumber | Betecknar valideringstyp för heltal. |
| Decimal | Betecknar valideringstyp för decimaltal. |
| List | Betecknar valideringstyp för nedrullningslistan. |
| Date | Betecknar valideringstyp för datum. |
| Time | Betecknar valideringstyp för tid. |
| TextLength | Betecknar valideringstyp för längden av text. |
| Custom | Betecknar anpassad valideringstyp. |
Heltalsdatavalidering
Med denna typ av validering kan användare bara ange heltal inom ett specificerat intervall i de validerade cellerna. Följande kodexempel visar hur man implementerar WholeNumber-typ av validering. Exemplet skapar samma data validering med Aspose.Cells for Node.js via C++ som vi skapade med Microsoft Excel ovan.
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 egenskapen Validation.setInCellDropDown(boolean) på true.
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.
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.
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.
Data valideringsregler
När datavalideringar implementeras kan valideringen kontrolleras genom att tilldela olika värden i cellerna. Cell.getValidationValue() kan användas för att hämta valideringsresultatet. Följande exempel visar den här funktionen med olika värden. Exempelfilen kan hämtas via länken nedan för testning:
sampleDataValidationRules.xlsx
Kontrollera om valideringen i cellen är rullgardinsmeny
Som vi har sett finns det många typer av valideringar som kan implementeras inom en cell. Om du vill kontrollera om valideringen är en rullgardinslista, kan Validation.getInCellDropDown()-metoden användas för att testa detta. Följande exempel visar användningen av denna egenskap. En testfil kan laddas ner via länken nedan:
Lägg till CellArea till befintlig validering
Det kan finnas situationer där du vill lägga till CellArea till befintliga Validation. När du lägger till CellArea med Validation.addArea(CellArea) kontrollerar Aspose.Cells alla befintliga områden för att se om det nya området redan finns. Om filen har många valideringar kan detta påverka prestandan. För att lösa detta finns metoden Validation.addArea(CellArea, boolean, boolean). Parametern checkIntersection anger om korsningen mellan ett givet område och befintliga valideringsområden ska kontrolleras. Att sätta den till false kommer att inaktivera kontroll av andra områden. Parametern checkEdge indikerar om de tillämpade områdena ska kontrolleras. Om det nya området blir det övre vänstra området, byggs interna inställningar om. Om du är säker på att det nya området inte är det övre vänstra, kan du ange denna parameter som false.
Följande kodsnutt visar användningen av Validation.addArea(CellArea, boolean, boolean)-metoden för att lägga till en ny CellArea till befintliga Validation.
Käll- och utdataexcelfilerna är bilagda som referens.