DataColumn.Expression 属性

DataColumn.Expression 属性

获取或设置表达式,用于筛选行、计算列中的值或创建聚合列。

命名空间:System.Data
程序集:System.Data(在 system.data.dll 中)

 
public string Expression { get; set; }
 
/** @property */
public String get_Expression ()

/** @property */
public void set_Expression (String value)

 
public function get Expression () : String

public function set Expression (value : String)

属性值

用来计算列的值,或创建聚合列的表达式。表达式的返回类型由列的 DataType 来确定。
异常类型条件

ArgumentException

AutoIncrementUnique 属性设置为 true

FormatException

在使用 CONVERT 函数时,表达式的计算结果为一个字符串,但该字符串不包含可以转换成类型参数的表示形式。

InvalidCastException

在使用 CONVERT 函数时,所请求的强制转换不可能完成。有关可能的强制转换的详细信息,请参见下面一节中的 Conversion 函数。

ArgumentOutOfRangeException

在使用 SUBSTRING 函数时,起始参数超出范围。

- 或 -

在使用 SUBSTRING 函数时,长度参数超出范围。

Exception

在使用 LEN 函数或 TRIM 函数时,表达式的计算结果不是字符串。这包括计算结果为 Char 的表达式。

Expression 属性的一个用途是创建计算出的列。例如,若要计算税值,就要将单价乘以特定地区的税率。由于各地税率不同,不可能将单一税率放在一个列中;于是便用 Expression 属性来计算这个值,如下面这一部分中的 Visual Basic 代码所示:

DataSet1.Tables("Products").Columns("tax").Expression = "UnitPrice * 0.086"

第二个用途是创建聚合列。类似于计算出的值,聚合基于 DataTable 中的整个行集执行操作。一个简单的示例就是计算该集中返回的行数。这便是您将用来计算特定销售人员所完成的交易数的方法,如下面的 Visual Basic 代码所示:

 
 
 DataSet1.Tables("Orders").Columns("OrderCount").Expression = "Count(OrderID)"

表达式语法

在创建表达式时,使用 ColumnName 属性来引用列。例如,如果一个列的 ColumnName 是“UnitPrice”,而另一个是“Quantity”,则表达式将是:

"UnitPrice * Quantity"

Note注意

如果在表达式中使用了某个列,则该表达式就存在一个对该列的依赖项。重命名或移除依赖列时不会引发异常。当访问缺少了依赖项的表达式列时,将引发异常。

在为筛选器创建表达式时,用单引号将字符串括起来:

"LastName = 'Jones'"

下面的字符是特殊字符,如下面所解释的,如果它们用于列名称中,就必须进行转义:

\n (newline)

\t (tab)

\r (carriage return)

~

(

)

#

\

/

=

>

<

+

-

*

%

&

|

^

'

"

[

]

如果列名称包含上面的字符之一,该名称必须用中括号括起来。例如,若要在表达式中使用名为“Column#”的列,应写成“[Column#]”:

Total * [Column#]

由于中括号是特殊字符,如果它是列名称的组成部分,必须使用斜杠 ("\") 将中括号转义。例如,名为“Column[]”的列应写成:

Total * [Column[\]]

(只有第二个中括号必须转义。)

用户定义的值

用户定义的值可以用在将与列值进行比较的表达式内。字符串的值应括在单引号内。日期值应放在磅符号 (#) 内。对于数值,允许使用小数和科学记数法。例如:

"FirstName = 'John'"

"Price <= 50.00"

"Birthdate < #1/31/82#"

对于包含枚举值的列,将值强制转换为整数数据类型。例如:

"EnumColumn = 5"

运算符

使用布尔值 AND、OR 和 NOT 运算符时允许串联。可以使用括号来组合子句和强制优先级。AND 运算符优先于其他运算符。例如:

(LastName = 'Smith' OR LastName = 'Jones') AND FirstName = 'John'

在创建比较表达式时,允许使用下列运算符:

<

>

<=

>=

<>

=

IN

LIKE

在表达式中还支持下列算术运算符:

+(加)

-(减)

*(乘)

/(除)

%(模数)

字符串运算符

若要连接字符串,请使用 + 字符。DataSet 类的 CaseSensitive 属性的值确定字符串比较是否区分大小写。但是,可以用 DataTable 类的 CaseSensitive 属性重写该值。

通配符

在 LIKE 比较中,* 和 % 两者可以互换地作为通配符。如果 LIKE 子句中的字符串包含 * 或 %,那么这些字符应用中括号([])对其进行转义。如果子句中有中括号,那么中括号字符应用中括号对其进行转义(例如 [[] 或 []])。在模式的开头和结尾,或者在模式的结尾,或在模式的开头,都允许使用通配符。例如:

"ItemName LIKE '*product*'"

"ItemName LIKE '*product'"

"ItemName LIKE 'product*'"

在字符串的中间不允许使用通配符。例如,不允许 'te*xt'。

父/子关系引用

通过在列名称前面加 Parent,就可以在表达式中引用父表。例如,Parent.Price 引用父表的名为 Price 的列。

通过在列名称前面加一个 Child,就可以在表达式中引用子表中的列。但是,因为子关系可以返回多行,所以必须在聚合函数中包括对子列的引用。例如,Sum(Child.Price) 将返回子表中名为 Price 的列的总和。

如果某个表有多个子表,则语法是:Child(RelationName)。例如,如果某个表有两个子表,它们的名称分别为 CustomersOrders,并且 DataRelation 对象被命名为 Customers2Orders,则引用将为:

Avg(Child(Customers2Orders).Quantity)

聚合

支持下列聚合类型:

Sum(求和)

Avg(平均)

Min(最小值)

Max(最大值)

Count(计数)

StDev(统计标准偏差)

Var(统计方差)。

聚合通常沿着关系执行。通过使用上面列出的函数之一和上面“父/子关系引用”中详述的子表列,来创建聚合表达式。例如:

Avg(Child.Price)

Avg(Child(Orders2Details).Price)

聚合也可以在单个表上执行。例如,若要为名为“Price”的列中的数字创建汇总,就用:

Sum(Price)

Note注意

如果使用一个表来创建聚合,将没有组合功能。相反,所有行都在列中显示相同的值。

如果表没有行,聚合函数将返回 空引用(在 Visual Basic 中为 Nothing)。

数据类型总是可以通过检查列的 DataType 属性来确定。还可以使用 Convert 函数来转换数据类型,如下面这一部分所示。

FUNCTIONS

还支持下列函数:

CONVERT

说明

将特定表达式转换为指定的 .NET Framework 类型。

语法

Convert(expression, type)

参数

expression — 要转换的表达式。

type — 值将转换成的 .NET Framework 类型。

例如:myDataColumn.Expression="Convert(total, 'System.Int32')"

所有转换都是有效的,只有下列情况例外:Boolean 只能与 ByteSByteInt16Int32Int64UInt16UInt32UInt64String 和它本身相互转换。Char 只能与 Int32UInt32String 和它本身相互转换。DateTime 只能与 String 和它本身相互转换。TimeSpan 只能与 String 和它本身相互转换。

LEN

说明

获取字符串的长度

语法

LEN(expression)

参数

expression — 要计算的字符串。

例如:myDataColumn.Expression="Len(ItemName)"

ISNULL

说明

检查表达式并返回已检查的表达式或返回替换值。

语法

ISNULL(expression, replacementvalue)

参数

expression — 要检查的表达式。

replacementvalue — 如果表达式为 空引用(在 Visual Basic 中为 Nothing),则返回 replacementvalue

例如:myDataColumn.Expression="IsNull(price, -1)"

IIF

说明

根据逻辑表达式的结果,获取两个值之一。

语法

IIF(expr, truepart, falsepart)

参数

expr — 要计算的表达式。

truepart — 表达式为真时返回的值。

falsepart — 表达式为假时返回的值。

例如:myDataColumn.Expression = "IIF(total>1000, 'expensive', 'dear')

TRIM

说明

移除所有前导的和后缀的空格字符,如 \r、\n、\t、' '

语法

TRIM(expression)

参数

expression — 要剪裁的表达式。

SUBSTRING

说明

获取从字符串中的指定点开始,具有指定长度的子字符串。

语法

SUBSTRING(expression, start, length)

参数

expression — 子字符串的源字符串。

start — 指定子字符串开始位置的整数。

length — 指定子字符串长度的整数。

例如:myDataColumn.Expression = "SUBSTRING(phone, 7, 8)"

Note注意

可以向 Expression 属性分配一个空值或空字符串,来重置该属性。如果为表达式列设置了一个默认值,则在重置 Expression 属性之后,这个默认值就赋给所有以前填充过的行。

下面的示例在 DataTable 中创建三个列。第二和第三列包含表达式;第二列使用可变税率计算税款,第三列将计算的结果添加到第一列的值。结果表显示在 DataGrid 控件中。

 
private void CalcColumns()
{
    DataTable table = new DataTable ();
 
    // Create the first column.
    DataColumn priceColumn = new DataColumn();
    priceColumn.DataType = System.Type.GetType("System.Decimal");
    priceColumn.ColumnName = "price";
    priceColumn.DefaultValue = 50;
     
    // Create the second, calculated, column.
    DataColumn taxColumn = new DataColumn();
    taxColumn.DataType = System.Type.GetType("System.Decimal");
    taxColumn.ColumnName = "tax";
    taxColumn.Expression = "price * 0.0862";
     
    // Create third column.
    DataColumn totalColumn = new DataColumn();
    totalColumn.DataType = System.Type.GetType("System.Decimal");
    totalColumn.ColumnName = "total";
    totalColumn.Expression = "price + tax";

    // Add columns to DataTable.
    table.Columns.Add(priceColumn);
    table.Columns.Add(taxColumn);
    table.Columns.Add(totalColumn);

    DataRow row = table.NewRow();
    table.Rows.Add(row);
    DataView view = new DataView(table);
    dataGrid1.DataSource = view;
}

原文地址:https://www.cnblogs.com/zl253539819/p/2844342.html