User.GetPropertiesAsync(IVectorView<String>) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得使用者的屬性。
public:
virtual IAsyncOperation<IPropertySet ^> ^ GetPropertiesAsync(IVectorView<Platform::String ^> ^ values) = GetPropertiesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IPropertySet> GetPropertiesAsync(IVectorView<winrt::hstring> const& values);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IPropertySet> GetPropertiesAsync(IReadOnlyList<string> values);function getPropertiesAsync(values)Public Function GetPropertiesAsync (values As IReadOnlyList(Of String)) As IAsyncOperation(Of IPropertySet)參數
- values
-
IVectorView<Platform::String>
IVectorView<winrt::hstring>
要取得的屬性。 使用 KnownUserProperties 類別來取得屬性名稱。
傳回
這個方法完成時，它會傳回要求的屬性。 如果屬性遺失或無法使用，則會回報為空字串。
- 屬性
Windows 需求
| 應用程式功能 |
userAccountInformation
|
備註
並非所有屬性都可供所有使用者使用。 下表摘要說明各種條件下可用的屬性。
| 屬性 | 未加入網域的本機帳戶 | 已加入本機帳戶網域 | MSA 帳戶 | AAD 帳戶 |
|---|---|---|---|---|
| AccountName | 無法使用 | 無法使用 | 無法使用 | 無法使用 |
| DisplayName | 無法使用 | 無法使用 | 無法使用 | 如果已加入網域，可以使用 |
| DomainName | 無法使用 | 可用 | 無法使用 | 可用 |
| 名字 | 可用 | 可用 | 可用 | 可用 |
| GuestHost | 可在 XBOX 上使用 | 可在 XBOX 上使用 | 可在 XBOX 上使用 | 可在 XBOX 上使用 |
| 姓氏 | 可用 | 可用 | 可用 | 可用 |
| 主體名稱 | 無法使用 | 可用 | 無法使用 | 如果已加入網域，可以使用 |
| ProviderName | 無法使用 | 無法使用 | 無法使用 | 無法使用 |
| SessionInitiationProtocolUri | 無法使用 | 可用 | 無法使用 | 如果已加入網域，可以使用 |