ISqlWhereAndOr<TBuilder>.OrWhere(string left, SqlBinaryOperator sqlOperator, ISqlBuilder sqlBuilder) Method

.NET Standard 2.x

Adds the OR logical operator and a search condition to the WHERE clause; and specifies a SQL expression on the left of the operator and a SQL subquery on the right.

Namespace: SnapObjects.Data

Assembly: SnapObjects.Data.dll

Syntax

  TBuilder OrWhere(string left, SqlBinaryOperator sqlOperator, ISqlBuilder sqlBuilder);

Parameters

left System.String

A SQL expression on the left of the operator.

SqlBinaryOperator SnapObjects.Data.SqlBinaryOperator

An enumeration value of SqlBinaryOperator, which is the operator to test the two expressions on the left and right.

sqlBuilder SnapObjects.Data.ISqlBuilder

An ISqlBuilder object which represents a SQL subquery on the right of the operator.

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 uses the result set of a subquery and the greater than 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 Example6()
        {

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

            // Defines a subquery.
            var deptsql = new SqlQueryBuilder();
            deptsql.SelectRaw("Min(DepartmentID)")
                .From("Department");

            // Defines a SQL statement; adds an OR WHERE condition:
            // a.DepartmentID greater than the result of a subquery   
            sqlbuilder.Select("Title")
                .From("Course", "a")
                .Where("CourseID", SqlBinaryOperator.GreaterThan,
                      SqlBuilder.Parameter<int>("courid"))
               .OrWhere("a.DepartmentID", SqlBinaryOperator.GreaterThan, deptsql);

            string sql = sqlbuilder.ToSqlString(_context);

            Console.WriteLine(sql);

            /*This code produces the following output:

            SELECT
            [Title]
            FROM [Course] AS [a]
            WHERE ([CourseID] > @courid
            OR [a].[DepartmentID] > (SELECT
            MIN([DepartmentID])
            FROM [Department]))
           */
        }
    }
}

Applies to

.NET Standard

2.x