DataColumn.Expression 属性
NET Framework 类库
DataColumn.Expression 属性
获取或设置表达式,用于筛选行、计算列中的值或创建聚合列。 命名空间:System.Data 语法
Visual Basic(声明)
Public Property Expression As String Visual Basic(用法)
Dim instance As DataColumn Dim value As String value = instance.Expression instance.Expression = value C#
public string Expression { get; set; } C++
public: property String^ Expression { String^ get (); void set (String^ value); } 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 来确定。异常
备注
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
例如: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
例如:myDataColumn.Expression="Len(ItemName)" ISNULL
例如:myDataColumn.Expression="IsNull(price, -1)" IIF
例如:myDataColumn.Expression = "IIF(total>1000, 'expensive', 'dear') TRIM
SUBSTRING
例如:myDataColumn.Expression = "SUBSTRING(phone, 7, 8)"
示例
下面的示例在 DataTable 中创建三个列。第二和第三列包含表达式;第二列使用可变税率计算税款,第三列将计算的结果添加到第一列的值。结果表显示在 DataGrid 控件中。 Visual Basic
Private Sub CalcColumns() Dim rate As Single = .0862 dim table as DataTable = New DataTable ' Create the first column. Dim priceColumn As DataColumn = New DataColumn With priceColumn .DataType = System.Type.GetType("System.Decimal") .ColumnName = "price" .DefaultValue = 50 End With ' Create the second, calculated, column. Dim taxColumn As DataColumn = New DataColumn With taxColumn .DataType = System.Type.GetType("System.Decimal") .ColumnName = "tax" .Expression = "price * 0.0862" End With ' Create third column Dim totalColumn As DataColumn = New DataColumn With totalColumn .DataType = System.Type.GetType("System.Decimal") .ColumnName = "total" .Expression = "price + tax" End With ' Add columns to DataTable With table.Columns .Add(priceColumn) .Add(taxColumn) .Add(totalColumn) End With Dim row As DataRow= table.NewRow table.Rows.Add(row) Dim view As New DataView view.Table = table DataGrid1.DataSource = view End Sub C#
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; } 平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition .NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。 |