StringCollection 声明转换

2025-08-22

本文提供了有关在 Azure Active Directory B2C（Azure AD B2C）中使用标识体验框架架构的字符串集合声明转换的示例。有关详细信息，请参阅声明转换。

AddItemToStringCollection

将字符串声明添加到新的唯一值 stringCollection 声明。查看此声明转换的实时演示。

元素	TransformationClaimType	数据类型	注释
InputClaim	项	字符串	要添加到输出声明的 ClaimType。
InputClaim	收藏	stringCollection	要添加到输出声明的字符串集合。如果集合包含项，则声明转换将复制项，并将该项添加到输出集合声明的末尾。
OutputClaim	收藏	stringCollection	调用此声明转换后生成的 ClaimType，并在输入声明中指定的值。

使用此声明转换将字符串添加到新的或现有的 stringCollection。它通常用于 AAD-UserWriteUsingAlternativeSecurityId 技术配置文件。在创建新的社交帐户之前， CreateOtherMailsFromEmail 声明转换将读取 ClaimType 并将该值添加到 其他Mails ClaimType。

AddItemToStringCollection 的示例

以下声明转换将 电子邮件 ClaimType 添加到 otherMails ClaimType。

<ClaimsTransformation Id="CreateOtherMailsFromEmail" TransformationMethod="AddItemToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="item" />
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>

输入声明：
- collection： [“someone@outlook.com”]
- item： “admin@contoso.com”
输出声明：
- collection： [“”someone@outlook.com， “admin@contoso.com”]

AddParameterToStringCollection

将字符串参数添加到新的唯一值 stringCollection 声明。查看此声明转换的实时演示。

元素	TransformationClaimType	数据类型	注释
InputClaim	收藏	stringCollection	要添加到输出声明的字符串集合。如果集合包含项，则声明转换将复制项，并将该项添加到输出集合声明的末尾。
InputParameter	项	字符串	要添加到输出声明的值。
OutputClaim	收藏	stringCollection	调用此声明转换后生成的 ClaimType，并在输入参数中指定的值。

AddParameterToStringCollection 的示例

以下示例将常量电子邮件地址（admin@contoso.com）添加到 otherMails 声明。

<ClaimsTransformation Id="SetCompanyEmail" TransformationMethod="AddParameterToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="item" DataType="string" Value="admin@contoso.com" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>

输入声明：
- collection： [“someone@outlook.com”]
输入参数
- item： “admin@contoso.com”
输出声明：
- collection： [“”someone@outlook.com， “admin@contoso.com”]

GetSingleItemFromStringCollection

从提供的字符串集合中获取第一项。查看此声明转换的实时演示。

元素	TransformationClaimType	数据类型	注释
InputClaim	收藏	stringCollection	声明转换用于获取项的 ClaimTypes。
OutputClaim	extractedItem	字符串	调用此 ClaimsTransformation 后生成的 ClaimType。集合中的第一项。

GetSingleItemFromStringCollection 的示例

以下示例读取 otherMails 声明，并将第一个项目返回到 电子邮件 声明。

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>

输入声明：
- collection： [“”someone@outlook.com， “someone@contoso.com”]
输出声明：
- extractedItem： “someone@outlook.com”

StringCollectionContains

检查 StringCollection 声明类型是否包含元素。查看此声明转换的实时演示。

元素	TransformationClaimType	数据类型	注释
InputClaim	inputClaim	stringCollection	要搜索的声明。
InputParameter	项	字符串	要搜索的值。
InputParameter	ignoreCase	字符串	指定此比较是否应忽略要比较的字符串大小写。
OutputClaim	outputClaim	布尔	调用此 ClaimsTransformation 后生成的 ClaimType。如果集合包含此类字符串，则为布尔指示器

StringCollectionContains 的示例

以下示例检查 stringCollection 声明类型是否 roles 包含 管理员的值。

<ClaimsTransformation Id="IsAdmin" TransformationMethod="StringCollectionContains">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="inputClaim"/>
  </InputClaims>
  <InputParameters>
    <InputParameter  Id="item" DataType="string" Value="Admin"/>
    <InputParameter  Id="ignoreCase" DataType="string" Value="true"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isAdmin" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

输入声明：
- inputClaim： [“reader”， “author”， “admin”]
输入参数：
- 项目：“管理员”
- ignoreCase：“true”
输出声明：
- outputClaim： “true”

StringCollectionContainsClaim

检查 StringCollection 声明类型是否包含声明值。查看此声明转换的实时演示。

元素	TransformationClaimType	数据类型	注释
InputClaim	收藏	stringCollection	要搜索的声明。
InputClaim	项	字符串	包含要搜索的值的声明类型。
InputParameter	ignoreCase	字符串	指定此比较是否应忽略要比较的字符串大小写。
OutputClaim	outputClaim	布尔	调用此 ClaimsTransformation 后生成的 ClaimType。如果集合包含此类字符串，则为布尔指示器

StringCollectionContainsClaim 的示例

以下示例检查 stringCollection 声明类型是否 roles 包含声明类型的值 role 。

<ClaimsTransformation Id="HasRequiredRole" TransformationMethod="StringCollectionContainsClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="collection" />
    <InputClaim ClaimTypeReferenceId="role" TransformationClaimType="item" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="ignoreCase" DataType="string" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="hasAccess" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

输入声明：
- collection： [“reader”， “author”， “admin”]
- 项目：“管理员”
输入参数：
- ignoreCase：“true”
输出声明：
- outputClaim： “true”

后续步骤

在 Azure AD B2C 社区 GitHub 存储库上查找更多声明转换示例

共用方式為