ISqlWhereAndOr<TBuilder>.OrWhere(string left, ISqlParameter parameter) Method

.NET Standard 2.x

Adds the OR logical operator and a search condition to the WHERE clause; and specifies a SQL expression to the left of the operator and a SQL parameter to the right of the operator. The operator is '='.

Namespace: SnapObjects.Data

Assembly: SnapObjects.Data.dll

Syntax

  TBuilder OrWhere(string left, ISqlParameter parameter);

Parameters

left System.String

A SQL expression on the left of the operator.

parameter SnapObjects.Data.ISqlParameter

An ISqlParameter object which represents a SQL parameter.

It can be created by calling the SqlBuilder.Parameter method.

Returns

TBuilder

Returns the TBuilder object which can be used to add more search conditions to the current WHERE clause.

Examples

The following code example demonstrates how to use the OrWhere method to add an OR condition to the WHERE clause. In this example, the OR condition will have a dynamic value which is specified by an input parameter and use the default operator "=".

using SnapObjects.Data;
using System;

namespace Appeon.ApiDoc.ISqlWhereAndOrExamples
{
    public class OrWhereExample
    {
        private readonly SchoolContext _context;

        public OrWhereExample(SchoolContext dataContext)
        {
            // Sets data context.
            _context = dataContext;
        }

        public void Example1()
        {

            // Declares SqlQueryBuilder.
            var sqlbuilder = new SqlQueryBuilder();

            // Defines a SQL statement.
            // Adds a OR WHERE condition: DepartmentID = @deptid (a parameter)
            sqlbuilder.Select("*")
                .From("Course")
                .Where("CourseID", SqlBinaryOperator.GreaterThan,
                        SqlBuilder.Parameter<int>("courid"))
                .OrWhere("DepartmentID", SqlBuilder.Parameter<int>("deptid"));

            string sql = sqlbuilder.ToSqlString(_context);

            Console.WriteLine(sql);

            /*This code produces the following output:

            SELECT
            *
            FROM [Course]
            WHERE ([CourseID] > @courid
            OR [DepartmentID] = @deptid)
           */
        }
    }
}

Applies to

.NET Standard

2.x