ColumnProxy 類別

Fluent 代理，用來從欄位名稱建立 OData 濾波器表達式。

回覆者 col。運算子過載與方法會產生 FilterExpression 可傳遞給 QueryBuilder.where()的實例。

範例：


   from PowerPlatform.Dataverse.models.filters import col

   expr = col("statecode") == 0               # equality
   expr = col("revenue") > 1_000_000          # comparison
   expr = col("name").like("Contoso%")        # startswith
   expr = col("name").is_null()               # null check
   expr = col("statecode").in_([0, 1])        # in

建構函式

ColumnProxy(name: str)

參數

名稱	Description
name 必要

方法

between	在濾波器之間： `(column ge lo and column le hi)`。
contains	包含過濾器： `contains(column, value)`。
endswith	以篩選器結束： `endswith(column, value)`。
in_	在濾波器中使用`Microsoft.Dynamics.CRM.In`。
is_not_null	欄位非空： `column ne null`。
is_null	欄位等於空值： `column eq null`。
like	模式匹配濾波器編譯為最接近的 OData 對應版本。
not_between	非中間濾鏡： `not (column ge lo and column le hi)`。
not_in	非入式濾波器使用 `Microsoft.Dynamics.CRM.NotIn`。
not_like	消除模式匹配濾波器;鏡子、 like 規則、然後否定。
startswith	以篩選器開始： `startswith(column, value)`。

between

在濾波器之間： (column ge lo and column le hi)。

between(lo: Any, hi: Any) -> FilterExpression

參數

名稱	Description
lo 必要
hi 必要

contains

包含過濾器： contains(column, value)。

contains(value: str) -> FilterExpression

參數

名稱	Description
value 必要

endswith

以篩選器結束： endswith(column, value)。

endswith(value: str) -> FilterExpression

參數

名稱	Description
value 必要

in_

在濾波器中使用Microsoft.Dynamics.CRM.In。

in_(values: Collection[Any]) -> FilterExpression

參數

名稱	Description
values 必要	非空值集合。

例外狀況

類型	Description
ValueError	如果 `values` 是空的。

is_not_null

欄位非空： column ne null。

is_not_null() -> FilterExpression

is_null

欄位等於空值： column eq null。

is_null() -> FilterExpression

like

模式匹配濾波器編譯為最接近的 OData 對應版本。

like(pattern: str) -> FilterExpression

參數

名稱	Description
pattern 必要	LIKE風格的花紋繩。

例外狀況

類型	Description
ValueError	如果無法簡化為單一的 OData 函數。

not_between

非中間濾鏡： not (column ge lo and column le hi)。

not_between(lo: Any, hi: Any) -> FilterExpression

參數

名稱	Description
lo 必要
hi 必要

not_in

非入式濾波器使用 Microsoft.Dynamics.CRM.NotIn。

not_in(values: Collection[Any]) -> FilterExpression

參數

名稱	Description
values 必要	非空值集合。

例外狀況

類型	Description
ValueError	如果 `values` 是空的。

not_like

消除模式匹配濾波器;鏡子、 like 規則、然後否定。

not_like(pattern: str) -> FilterExpression

參數

名稱	Description
pattern 必要	LIKE 風格的圖案字串（與 like相同規則）。

例外狀況

類型	Description
ValueError	如果無法簡化為單一的 OData 函數。

startswith

以篩選器開始： startswith(column, value)。

startswith(value: str) -> FilterExpression

參數

名稱	Description
value 必要