共用方式為


泛型 Field 和 SetField 方法 (LINQ to DataSet)

LINQ to DataSet 提供 DataRow 類別的擴充方法來存取資料行值:Field 方法和 SetField 方法。 這些方法可讓開發人員更容易存取資料行值,尤其是與 Null 值相關的情況。 DataSet 會使用 DBNull.Value 來表示 Null 值,而 LINQ 則使用 NullableNullable<T> 型別。 如果使用 DataRow 中的現有資料行存取子,您就必須將傳回物件轉型為適當的型別。 如果 DataRow 中的特定欄位可為 Null,您就必須明確檢查是否有 Null 值,因為傳回 DBNull.Value 並將其隱含轉型為其他型別會擲回 InvalidCastException。 在下列範例中,如果 DataRow.IsNull 方法沒有用來檢查是否有 Null 值,而且索引子傳回了 DBNull.Value 並嘗試將其轉型為 String,系統就會擲回例外狀況。

// Fill the DataSet.
DataSet ds = new DataSet();
ds.Locale = CultureInfo.InvariantCulture;
FillDataSet(ds);

DataTable products = ds.Tables["Product"];

var query =
    from product in products.AsEnumerable()
    where !product.IsNull("Color") &&
        (string)product["Color"] == "Red"
    select new
    {
        Name = product["Name"],
        ProductNumber = product["ProductNumber"],
        ListPrice = product["ListPrice"]
    };

foreach (var product in query)
{
    Console.WriteLine("Name: {0}", product.Name);
    Console.WriteLine("Product number: {0}", product.ProductNumber);
    Console.WriteLine("List price: ${0}", product.ListPrice);
    Console.WriteLine("");
}
' Fill the DataSet.
Dim ds As New DataSet()
ds.Locale = CultureInfo.InvariantCulture
' See the FillDataSet method in the Loading Data Into a DataSet topic.
FillDataSet(ds)

Dim products As DataTable = ds.Tables("Product")

Dim query = _
    From product In products.AsEnumerable() _
    Where product!Color IsNot DBNull.Value AndAlso product!Color = "Red" _
    Select New With _
       { _
           .Name = product!Name, _
           .ProductNumber = product!ProductNumber, _
           .ListPrice = product!ListPrice _
       }

For Each product In query
    Console.WriteLine("Name: " & product.Name)
    Console.WriteLine("Product number: " & product.ProductNumber)
    Console.WriteLine("List price: $" & product.ListPrice & vbNewLine)
Next

Field 方法可讓您存取 DataRow 的資料行值而 SetField 會設定 DataRow 中的資料行值。 由於 Field 方法和 SetField 方法都會處理可為 Null 值的型別,因此您不需要明確檢查是否有 Null 值 (如同上一個範例)。 此外,這兩種方法都是泛型方法,所以您不需要轉型傳回型別。

下列範例使用 Field 方法。

// Fill the DataSet.
DataSet ds = new DataSet();
ds.Locale = CultureInfo.InvariantCulture;
FillDataSet(ds);

DataTable products = ds.Tables["Product"];

var query =
    from product in products.AsEnumerable()
    where product.Field<string>("Color") == "Red"
    select new
    {
        Name = product.Field<string>("Name"),
        ProductNumber = product.Field<string>("ProductNumber"),
        ListPrice = product.Field<Decimal>("ListPrice")
    };

foreach (var product in query)
{
    Console.WriteLine("Name: {0}", product.Name);
    Console.WriteLine("Product number: {0}", product.ProductNumber);
    Console.WriteLine("List price: ${0}", product.ListPrice);
    Console.WriteLine("");
}
' Fill the DataSet.
Dim ds As New DataSet()
ds.Locale = CultureInfo.InvariantCulture
' See the FillDataSet method in the Loading Data Into a DataSet topic.
FillDataSet(ds)

Dim products As DataTable = ds.Tables("Product")

Dim query = _
    From product In products.AsEnumerable() _
    Where product.Field(Of String)("Color") = "Red" _
    Select New With _
       { _
           .Name = product.Field(Of String)("Name"), _
           .ProductNumber = product.Field(Of String)("ProductNumber"), _
           .ListPrice = product.Field(Of Decimal)("ListPrice") _
       }

For Each product In query
    Console.WriteLine("Name: " & product.Name)
    Console.WriteLine("Product number: " & product.ProductNumber)
    Console.WriteLine("List price: $ " & product.ListPrice & vbNewLine)
Next

請注意,T 方法和 Field 方法之泛型參數 SetField 中指定的資料型別必須與基礎值的型別相符。 否則,系統將擲回 InvalidCastException 例外狀況。 此外,指定的資料行名稱也必須與 DataSet 中的資料行名稱相符,否則系統將擲回 ArgumentException。 在這兩種情況中,其例外狀況是在執行查詢的資料列舉執行階段中擲回。

SetField 方法本身不會執行任何型別轉換。 不過,這並不表示不會進行型別轉換。 SetField 方法會公開 DataRow 類別的 ADO.NET 行為。 DataRow 物件可以執行型別轉換,然後再將轉換的值儲存至 DataRow 物件。

另請參閱