ClientApplicationBase.AcquireTokenSilent 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[V3 API]嘗試從使用者令牌快取取得存取 |
| AcquireTokenSilent(IEnumerable<String>, String) |
[V3 API]嘗試從用戶令牌快取中取得存取Username權杖以取得IAccount與所給定 |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[V3 API]嘗試從使用者令牌快取取得存取 account 權杖。
如需詳細資訊，請參閱https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, Microsoft.Identity.Client.IAccount account);abstract member AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), account As IAccount) As AcquireTokenSilentParameterBuilder參數
- scopes
- IEnumerable<String>
請求存取受保護 API 的範圍
- account
- IAccount
請用該代幣的帳戶。
傳回
AcquireTokenSilentParameterBuilder用來建立標記請求，並加入可選參數
實作
例外狀況
當需要與應用程式最終使用者互動時，例如快取中沒有刷新令牌，或使用者需要同意、重新登入（例如密碼過期），或使用者需要執行雙重驗證時，會被拋出
備註
若存取權 杖至少包含 所有請求範圍，則視為匹配。 這表示存取權杖的範圍超過請求範圍，可能會被回傳。 若存取權杖在 5 分鐘內過期或接近到期，則會利用快取的刷新權杖（如有）透過靜默網路呼叫取得新的存取權杖。
你可以透過串接建構器來設定額外參數： WithTenantId(String) 請求一個與應用程式建構 WithForceRefresh(Boolean) 時設定不同權威的權威權威，繞過使用者權杖快取並強制刷新該權杖，以及 Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) 指定額外的查詢參數
適用於
AcquireTokenSilent(IEnumerable<String>, String)
[V3 API]嘗試從用戶令牌快取中取得存取Username權杖以取得IAccount與所給定loginHint的匹配。
如需詳細資訊，請參閱https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, string loginHint);abstract member AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), loginHint As String) As AcquireTokenSilentParameterBuilder參數
- scopes
- IEnumerable<String>
請求存取受保護 API 的範圍
- loginHint
- String
通常是用戶名稱，以 UPN 格式呈現，例如 johnd@contoso.com
傳回
AcquireTokenSilentParameterBuilder用來建立標記請求，並加入可選參數
實作
例外狀況
當需要與應用程式最終使用者互動時，例如快取中沒有刷新令牌，或使用者需要同意、重新登入（例如密碼過期），或使用者需要執行雙重驗證時，會被拋出
備註
若多個 IAccount 匹配 ， loginHint或無匹配，則會拋出例外。
若存取權 杖至少包含 所有請求範圍，則視為匹配。 這表示存取權杖的範圍超過請求範圍，可能會被回傳。 若存取權杖在 5 分鐘內過期或接近到期，則會利用快取的刷新權杖（如有）透過靜默網路呼叫取得新的存取權杖。
你可以透過串接建構器來設定額外參數： WithTenantId(String) 請求一個與應用程式建構 WithForceRefresh(Boolean) 時設定不同權威的權威權威，繞過使用者權杖快取並強制刷新該權杖，以及 Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) 指定額外的查詢參數