DataColumn.Expression Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a expressão usada para filtrar linhas, calcular os valores em uma coluna ou criar uma coluna de agregação.
public:
property System::String ^ Expression { System::String ^ get(); void set(System::String ^ value); };public string Expression { get; set; }[System.Data.DataSysDescription("DataColumnExpressionDescr")]
public string Expression { get; set; }member this.Expression : string with get, set[<System.Data.DataSysDescription("DataColumnExpressionDescr")>]
member this.Expression : string with get, setPublic Property Expression As StringValor da propriedade
Uma expressão para calcular o valor de uma coluna, ou criar uma coluna agregada. O tipo de retorno de uma expressão é determinado pelo DataType da coluna.
- Atributos
Exceções
A propriedade AutoIncrement ou Unique é definida como true.
Quando você usa a função CONVERT, a expressão é avaliada como uma cadeia de caracteres, mas a cadeia de caracteres não contém uma representação que pode ser convertida para o parâmetro de tipo.
Quando você usa a função CONVERT, a conversão solicitada não é possível. Consulte a função Conversão na seção a seguir para obter informações detalhadas sobre as possíveis conversões.
Quando você usa a função SUBSTRING, o argumento de início está fora do intervalo.
-Ou-
Quando você usa a função SUBSTRING, o argumento de tamanho está fora do intervalo.
Quando você usa a função LEN ou TRIM, a expressão não é avaliada como uma cadeia de caracteres. Isso inclui as expressões avaliadas como Char.
Exemplos
O exemplo a seguir cria três colunas em um DataTable. A segunda e a terceira colunas contêm expressões; o segundo calcula o imposto usando uma taxa de imposto variável e o terceiro adiciona o resultado do cálculo ao valor da primeira coluna. A tabela resultante é exibida em um DataGrid controle .
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;
}
Private Sub CalcColumns()
Dim rate As Single = .0862
Dim table As New DataTable()
' Create the first column.
Dim priceColumn As New DataColumn()
With priceColumn
.DataType = System.Type.GetType("System.Decimal")
.ColumnName = "price"
.DefaultValue = 50
End With
' Create the second, calculated, column.
Dim taxColumn As New DataColumn()
With taxColumn
.DataType = System.Type.GetType("System.Decimal")
.ColumnName = "tax"
.Expression = "price * 0.0862"
End With
' Create third column
Dim totalColumn As 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
Comentários
Para obter mais informações sobre essa API, consulte Comentários da API complementar para DataColumn.Expression.
