DataColumn.Expression Propriété

Définition

Espace de noms:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Obtient ou définit l’expression utilisée pour filtrer les lignes, calculer les valeurs d’une colonne ou créer une colonne d’agrégation.

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

Valeur de propriété

String

Expression permettant de calculer la valeur d’une colonne ou de créer une colonne d’agrégation. Le type de retour d’une expression est déterminé par la DataType colonne.

Attributs
DataSysDescriptionAttribute

Exceptions

ArgumentException

La ou Unique la AutoIncrement propriété est définie sur true.

FormatException

Lorsque vous utilisez la fonction CONVERT, l’expression prend la valeur d’une chaîne, mais la chaîne ne contient pas de représentation qui peut être convertie en paramètre de type.

InvalidCastException

Lorsque vous utilisez la fonction CONVERT, le cast demandé n’est pas possible. Consultez la fonction Conversion dans la section suivante pour obtenir des informations détaillées sur les casts possibles.

ArgumentOutOfRangeException

Lorsque vous utilisez la fonction SUBSTRING, l’argument de début est hors plage.

- Ou -

Lorsque vous utilisez la fonction SUBSTRING, l’argument de longueur est hors plage.

Exception

Lorsque vous utilisez la fonction LEN ou la fonction TRIM, l’expression n’est pas évaluée à une chaîne. Cela inclut des expressions qui sont évaluées à Char.

Exemples

L’exemple suivant crée trois colonnes dans un DataTable. Les deuxième et troisième colonnes contiennent des expressions ; le deuxième calcule la taxe à l’aide d’un taux d’imposition variable, et le troisième ajoute le résultat du calcul à la valeur de la première colonne. La table obtenue s’affiche dans un DataGrid contrôle.

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

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour DataColumn.Expression.

S’applique à

Voir aussi