Aggiungi Cell Convalide

Una delle funzionalità avanzate di Aspose.Cells.GridWeb consiste nell’aggiungere regole di convalida dell’input per le celle. Gli sviluppatori possono creare diversi tipi di regole di convalida per le celle per controllare e convalidare i valori di input. Questo argomento illustra i tipi di convalida supportati e come crearli.

Tipi di convalide

È possibile applicare tre tipi di convalide utilizzando Aspose.Cells.GridWeb:

• Convalida elenco.
• Convalida dell’elenco a discesa.
• Convalida dell’espressione personalizzata.

Ognuno è discusso in dettaglio di seguito.

Convalida elenco

La convalida dell’elenco consente agli utenti di fornire l’input della cella digitando o selezionando un valore da un menu. Per creare una convalida elenco per una cella:

1. Aggiungere il controllo Aspose.Cells.GridWeb a un Web Form.
2. Accedi a un foglio di lavoro.
3. Accedi alla cella a cui aggiungere la convalida.
4. Creare la convalida per la cella e specificare il tipo di convalida come Elenco.
5. Aggiungere valori per la convalida dell’elenco.

Il codice di esempio aggiunge una convalida elenco a C1. Quando un utente fa clic sulla cella, viene visualizzato un elenco.

Output: selezione di un valore dall’elenco

// 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 dell’elenco a discesa

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

1. Aggiungere il controllo Aspose.Cells.GridWeb a un Web Form.
2. Accedi a un foglio di lavoro.
3. Accedi alla cella per cui creare la convalida.
4. Crea una convalida per la cella e specifica il tipo come DropDownList.
5. Aggiungere valori per la convalida.

Il codice di esempio aggiunge una convalida dell’elenco a discesa a C1. Quando un utente fa clic sulla cella, viene visualizzato un menu a discesa e gli utenti possono selezionare un valore da esso.

Selezione di un valore da un menu 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 delle espressioni personalizzate consente agli sviluppatori di scrivere le proprie espressioni regolari personalizzate per convalidare i valori di input. Per creare una convalida dell’espressione personalizzata:

1. Aggiungere il controllo Aspose.Cells.GridWeb a un Web Form.
2. Accedi a un foglio di lavoro.
3. Accedi alla cella per cui creare una convalida.
4. Crea una convalida per la cella e specifica il tipo come CustomExpression.
5. Imposta l’espressione regolare della convalida.

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

Aggiunta di un valore di data a C1 in base a 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 i dati di input a un server. Anche se sono presenti regole di convalida per celle diverse ma la proprietà ForceValidation del controllo GridWeb non è impostata su true, anche i dati di input errati verranno inviati al server e non viene forzata alcuna convalida. 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 finché 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, viene attivata la convalida lato client e gli utenti non possono pubblicare dati anche se fanno clic suInvia.

Valore di input errato evidenziato da GridWeb