DataColumn.Expression Propriedade

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém ou define a expressão usada para filtrar linhas, calcular os valores numa coluna ou criar uma coluna agregada.

public:
 property System::String ^ Expression { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DataColumnExpressionDescr")]
public string Expression { get; set; }
public string Expression { get; set; }
[<System.Data.DataSysDescription("DataColumnExpressionDescr")>]
member this.Expression : string with get, set
member this.Expression : string with get, set
Public Property Expression As String

Valor de Propriedade

String

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
DataSysDescriptionAttribute

Exceções

ArgumentException

A AutoIncrement propriedade or Unique é definida como true.

FormatException

Quando está a usar a função CONVERT, a expressão avalia-se para uma cadeia, mas a cadeia não contém uma representação que possa ser convertida para o parâmetro tipo.

InvalidCastException

Quando está a usar a função CONVERTER, o cast solicitado não é possível. Consulte a função Conversão na secção seguinte para informações detalhadas sobre possíveis fundições.

ArgumentOutOfRangeException

Quando usas a função SUBSTRING, o argumento start está fora do alcance.

-Ou-

Quando usas a função SUBSTRING, o argumento do comprimento está fora do alcance.

Exception

Quando usa a função LEN ou a função TRIM, a expressão não se avalia para uma cadeia. Isto inclui expressões que avaliam para Char.

Exemplos

O exemplo seguinte cria três colunas num DataTable. A segunda e terceira colunas contêm expressões; a segunda calcula o imposto usando uma taxa variável, e a terceira soma o resultado do cálculo ao valor da primeira coluna. A tabela resultante é apresentada num DataGrid controlo.

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

Observações

Para mais informações sobre esta API, consulte Observações suplementares sobre a API para DataColumn.Expression.

Aplica-se a

Ver também