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<String>

IReadOnlyList<String>

IVectorView<Platform::String>

IVectorView<winrt::hstring>

要取得的屬性。使用 KnownUserProperties 類別來取得屬性名稱。

這個方法完成時，它會傳回要求的屬性。如果屬性遺失或無法使用，則會回報為空字串。

userAccountInformation

並非所有屬性都可供所有使用者使用。下表摘要說明各種條件下可用的屬性。

屬性	未加入網域的本機帳戶	已加入本機帳戶網域	MSA 帳戶	AAD 帳戶
AccountName	無法使用	無法使用	無法使用	無法使用
DisplayName	無法使用	無法使用	無法使用	如果已加入網域，可以使用
DomainName	無法使用	可用	無法使用	可用
名字	可用	可用	可用	可用
GuestHost	可在 XBOX 上使用	可在 XBOX 上使用	可在 XBOX 上使用	可在 XBOX 上使用
姓氏	可用	可用	可用	可用
主體名稱	無法使用	可用	無法使用	如果已加入網域，可以使用
ProviderName	無法使用	無法使用	無法使用	無法使用
SessionInitiationProtocolUri	無法使用	可用	無法使用	如果已加入網域，可以使用