Xceed Workbooks for .NET v3.0 Documentation
Xceed.Workbooks.NET Assembly / Xceed.Workbooks.NET Namespace / DataValidation Class
Members Example


In This Topic
    DataValidation Class
    In This Topic
    Represents the data validation process used to validate the content of a Cell.
    Syntax
    'Declaration
     
    
    Public Class DataValidation 
    'Usage
     
    
    Dim instance As DataValidation
    public class DataValidation 
    Remarks
    The data validation process triggers warnings when the wrong type of data is entered in a Cell.
    Example
    DataValidation validation0= new DataValidation( ValidationType.WholeNumber, new DataValidationRangeCondition( RangeConditionType.Between, -100, 100 ) );
    
    DataValidation validation1 = DataValidation.Create( ValidationType.TextLength, new DataValidationRangeCondition( RangeConditionType.Between, 5, 10 ) );
    
    DataValidation validation2= DataValidation.Create( ValidationType.WholeNumber, new DataValidationSingleCondition( SingleConditionType.Equal, 6 ) );
    
    //Changes the validation condition
    validation0.Condition = new DataValidationSingleCondition( SingleConditionType.GreaterThan, 7 ) );
    using( var workbook = Workbook.Create( "AddDataValidation.xlsx" ) ) { 
    
    // Gets the first Worksheet; a Workbook always contains at least 1 Worksheet. 
    var worksheet = workbook.Worksheets[ 0 ]; 
    
    // Creates a new DataValidation and assigns it to Cells A1 to A3. 
    var dataValidation = new DataValidation( ValidationType.Decimal, DataComparisonType.LessThanOrEqual ) { Value = 10 }; dataValidation.SetError( "My Error", "Value must under 10", DataValidationErrorStyle.Warning ); worksheet.Cells[ "A1", "A3" ].DataValidation = dataValidation; 
    
    // Saves Workbook to disk; 
    workbook.Save(); }
    Inheritance Hierarchy

    System.Object
       Xceed.Workbooks.NET.DataValidation

    Public Constructors
    Public Fields
     NameDescription
    Public Field  
    Public Field   
    Top
    Public Properties
     NameDescription
    Public PropertyGets or sets the DataValidationCondition.  
    Public PropertyGets or sets if the DataValidation ignores blank Cells.  
    Public PropertyGets or sets if the Cell contains a drop-down menu offering choices that can be used for DataValidation.  
    Public PropertyGets the ValidationType.  
    Top
    Public Methods
     NameDescription
    Public MethodAdds a DataValidation in specific areas of the Worksheet.  
    Public Method  
    Public Methodstatic (Shared in Visual Basic)Creates a new DataValidation.  
    Public MethodOverloaded.   
    Public Method  
    Public MethodSets an error message.  
    Public MethodSets the message that will be displayed when the user selects or hovers over the target Cell(s).  
    Top
    Requirements

    Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also