DataColumn.Expression 属性

DataColumn.Expression 属性
NET Framework 类库 
DataColumn.Expression 属性 

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

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

语法语法
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 来确定。
异常异常
异常类型 条件

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

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
            
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 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0
posted @ 2006-11-22 09:11  ejiyuan  阅读(4168)  评论(0编辑  收藏  举报