DataColumn.Expression 属性
获取或设置表达式,用于筛选行、计算列中的值或创建聚合列。
命名空间:System.Data
程序集:System.Data(在 system.data.dll 中)
/** @property */ public String get_Expression () /** @property */ public void set_Expression (String value)
public function get Expression () : String public function set Expression (value : String)
属性值
用来计算列的值,或创建聚合列的表达式。表达式的返回类型由列的 DataType 来确定。异常类型 | 条件 |
---|---|
将 AutoIncrement 或 Unique 属性设置为 true。 |
|
在使用 CONVERT 函数时,表达式的计算结果为一个字符串,但该字符串不包含可以转换成类型参数的表示形式。 |
|
在使用 CONVERT 函数时,所请求的强制转换不可能完成。有关可能的强制转换的详细信息,请参见下面一节中的 Conversion 函数。 |
|
在使用 SUBSTRING 函数时,起始参数超出范围。 - 或 - 在使用 SUBSTRING 函数时,长度参数超出范围。 |
|
在使用 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"
注意 |
---|
如果在表达式中使用了某个列,则该表达式就存在一个对该列的依赖项。重命名或移除依赖列时不会引发异常。当访问缺少了依赖项的表达式列时,将引发异常。 |
在为筛选器创建表达式时,用单引号将字符串括起来:
"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)。例如,如果某个表有两个子表,它们的名称分别为 Customers 和 Orders,并且 DataRelation 对象被命名为 Customers2Orders,则引用将为:
Avg(Child(Customers2Orders).Quantity)
聚合
支持下列聚合类型:
Sum(求和)
Avg(平均)
Min(最小值)
Max(最大值)
Count(计数)
StDev(统计标准偏差)
Var(统计方差)。
聚合通常沿着关系执行。通过使用上面列出的函数之一和上面“父/子关系引用”中详述的子表列,来创建聚合表达式。例如:
Avg(Child.Price)
Avg(Child(Orders2Details).Price)
聚合也可以在单个表上执行。例如,若要为名为“Price”的列中的数字创建汇总,就用:
Sum(Price)
注意 |
---|
如果使用一个表来创建聚合,将没有组合功能。相反,所有行都在列中显示相同的值。 |
如果表没有行,聚合函数将返回 空引用(在 Visual Basic 中为 Nothing)。
数据类型总是可以通过检查列的 DataType 属性来确定。还可以使用 Convert 函数来转换数据类型,如下面这一部分所示。
FUNCTIONS
还支持下列函数:
CONVERT
说明 |
将特定表达式转换为指定的 .NET Framework 类型。 |
语法 |
Convert(expression, type) |
参数 |
expression — 要转换的表达式。 type — 值将转换成的 .NET Framework 类型。 |
例如:myDataColumn.Expression="Convert(total, 'System.Int32')"
所有转换都是有效的,只有下列情况例外:Boolean 只能与 Byte、SByte、Int16、Int32、Int64、UInt16、UInt32、UInt64、String 和它本身相互转换。Char 只能与 Int32、UInt32、String 和它本身相互转换。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)"
注意 |
---|
可以向 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; }