DataColumn.Expression 属性

DataColumn.Expression 属性

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

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

语法

---

C#

C++

VB

 

public string Expression { get; set; }

J#

 

/** @property */
public String get_Expression ()

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

JScript

 

public function get Expression () : String

public function set Expression (value : String)

属性值

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

异常

---

异常类型	条件
ArgumentException	将 AutoIncrement 或 Unique 属性设置为 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"

注意

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

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

"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 控件中。

C#

VB

 

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;
}