# FieldValueCount 脚本和图表功能

FieldValueCount() 是一个整数函数，用于返回字段中相异值的数量。

部分重新加载可以从数据中删除值，而这些值不会反映在返回的数字中。返回的数字将对应于初始重新加载或任何后续部分重新加载中加载的所有不同值。

信息注释当在图表的任何表达式中使用此图表函数时，不允许对图表中的 y 值进行排序或按表中的表达式列进行排序。因此，这些排序替代项会自动禁用。当您在可视化或表格中使用此图表函数时，可视化的排序将返回到此函数的排序输入。此限制不适用于等效的脚本函数。

语法：

FieldValueCount(field\_name)

返回数据类型： 整数

参数：

参数

| 参数 | 描述 |
| --- | --- |
| field\_name | 需要值的字段的名称。例如，表格中的列。 必须指定作为字符串值。这意味着必须用单引号将字段名称括起来。 |

示例和结果：

下例使用字段：表格 Names 中的 First name。

示例和结果

| 实例 | 结果 |
| --- | --- |
| 将示例数据添加到应用程序并运行。 | 加载表格 Names 作为样本数据。 |
| 图表函数：在包含维度 First name 的表格中，添加作为度量： |  |
| `FieldValueCount('First name')` | 5，因为 Peter 显示两次。 |
| `FieldValueCount('Initials')` | 6，因为 Initials 只有特殊值。 |
| 脚本函数：加载指定的表格 Names 作为示例数据： |  |
| `FieldCount1:` `Load FieldValueCount('First name') as MyFieldCount1` `Resident Names;` | `MyFieldCount1=`5，因为“Peter”显示两次。 |
| `FieldCount2:` `Load FieldValueCount('Initials') as MyInitialsCount1` `Resident Names;` | `MyFieldCount1=`6，因为“Initials”只有特殊值。 |

示例中所使用的数据：

```
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
			
FieldCount1:
Load FieldValueCount('First name') as MyFieldCount1
Resident Names;
 
FieldCount2:
Load FieldValueCount('Initials') as MyInitialsCount1
Resident Names;
```