Aggiungi Validazione Cellule

Uno dei più avanzati feature di Aspose.Cells.GridWeb è aggiungere regole di validazione di input per le celle. Gli sviluppatori possono creare diversi tipi di regole di validazione per le celle per controllare e validare i valori di input. Questo argomento discute i tipi di validazioni supportate e come crearle.

Tipi di Validazioni

Possono essere applicati tre tipi di validazioni utilizzando Aspose.Cells.GridWeb:

• Convalida della lista.
• Convalida della lista a discesa.
• Convalida dell’espressione personalizzata.

Ogni tipo di convalida verrà discusso in dettaglio di seguito.

Convalida della lista

La convalida della lista consente agli utenti di inserire un dato nella cella digitandolo o selezionandolo da un menu. Per creare una convalida della lista per una cella:

1. Aggiungi il controllo Aspose.Cells.GridWeb a un modulo Web.
2. Accedi a un foglio di lavoro.
3. Accedere alla cella a cui aggiungere la convalida.
4. Creare la convalida per la cell e specificare il tipo di convalida come Lista.
5. Aggiungere valori per la convalida della lista.

Il codice di esempio aggiunge una convalida della lista a C1. Quando un utente fa clic sulla cella, appare una lista.

Output: selezionare un valore dalla lista

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Select Course:");

// Accessing "C1" cell
cell = sheet.Cells[0, 2];

// Creating List validation for the "C1" cell
var validation = cell.CreateValidation(GridValidationType.List, true);

// Adding values to List validation
var values = new System.Collections.Specialized.StringCollection();
values.Add("Fortran");
values.Add("Pascal");
values.Add("C++");
values.Add("Visual Basic");
values.Add("Java");
values.Add("C#");
validation.ValueList = values;

Convalida della lista a discesa

La convalida della lista a discesa consente agli utenti di fornire un input per le celle selezionando un valore da un elenco predefinito. Per creare una convalida della lista a discesa:

1. Aggiungi il controllo Aspose.Cells.GridWeb a un modulo Web.
2. Accedi a un foglio di lavoro.
3. Accedere alla cella per creare la convalida.
4. Creare una convalida per la cella e specificare il tipo come DropDownList.
5. Aggiungere valori per la convalida.

Il codice di esempio aggiunge una convalida della lista a discesa a C1. Quando un utente fa clic sulla cella, compare un elenco a discesa e gli utenti possono selezionare un valore da esso.

Selezionare un valore da un elenco a discesa

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Select Degree:");

// Accessing "C1" cell
cell = sheet.Cells[0, 2];

// Creating DropDownList validation for the "C1" cell
var validation = cell.CreateValidation(GridValidationType.DropDownList, true);
            
// Adding values to DropDownList validation
var values = new System.Collections.Specialized.StringCollection();
values.Add("Bachelor");
values.Add("Master");
values.Add("Doctor");
validation.ValueList = values;

Convalida dell’espressione personalizzata

La convalida dell’espressione personalizzata consente agli sviluppatori di scrivere le proprie espressioni regolari personalizzate per convalidare i valori di input. Per creare una convalida dell’espressione personalizzata:

1. Aggiungi il controllo Aspose.Cells.GridWeb a un modulo Web.
2. Accedi a un foglio di lavoro.
3. Accedere alla cella per creare una convalida.
4. Creare una convalida per la cella e specificare il tipo come CustomExpression.
5. Impostare l’espressione regolare della convalida.

Il codice di esempio aggiunge una convalida di espressione personalizzata a C1. Gli utenti possono inserire solo una data nella cella secondo il formato specificato dall’espressione regolare.

Aggiunta di un valore data a C1 secondo un’espressione regolare

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Date (yyyy-mm-dd):");

// Access "C1" cell and add to it custom expression validation to accept dates in yyyy-mm-dd format
cell = sheet.Cells[0, 2];
var validation = cell.CreateValidation(GridValidationType.CustomExpression, true);
validation.RegEx = @"\d{4}-\d{2}-\d{2}";

Forzare la convalida

Utilizzando Aspose.Cells.GridWeb, gli utenti possono inviare dati di input a un server. Anche se ci sono regole di convalida per diverse celle, se la proprietà ForceValidation del controllo GridWeb non è impostata su true, i dati di input errati verranno comunque inviati al server e nessuna convalida sarà forzata. La proprietà ForceValidation di GridWeb è sempre impostata su true per impostazione predefinita.

Quando la proprietà ForceValidation è true, il controllo non invia dati al server web fino a quando i valori di input di tutte le celle non sono validi. Ad esempio, se qualcuno inserisce un valore di input non valido in una cella, o non inserisce un valore, la convalida lato client viene attivata e gli utenti non possono inviare dati anche se fanno clic su Invia.

Valore di input errato evidenziato da GridWeb