語言

DownstreamApiOptionsReadOnlyHttpMethod 類別

定義

專門化,指DownstreamApiOptionsHttpMethod的是除了建造階段外無法設定的部分。

public class DownstreamApiOptionsReadOnlyHttpMethod : Microsoft.Identity.Abstractions.DownstreamApiOptions
type DownstreamApiOptionsReadOnlyHttpMethod = class
    inherit DownstreamApiOptions
Public Class DownstreamApiOptionsReadOnlyHttpMethod
Inherits DownstreamApiOptions
繼承
DownstreamApiOptionsReadOnlyHttpMethod

備註

此類別有助於提供更好的開發者體驗,特別是在 HTTP 方法已以方法名稱命名且不應被選項覆蓋的專用方法 IDownstreamApi 上。 你不應該需要直接使用它。

建構函式

名稱 Description
DownstreamApiOptionsReadOnlyHttpMethod(DownstreamApiOptions, String)

Constructor fro 和 DownstreamApiOptions HTTP 方法。

屬性

名稱 Description
AcceptHeader

HTTP Accept 標頭用來告知該伺服器客戶端期望回應的內容類型。

(繼承來源 DownstreamApiOptions)
AcquireTokenOptions

與代幣取得相關的選項。

(繼承來源 AuthorizationHeaderProviderOptions)
BaseUrl

呼叫下游 Web API 的基礎網址。 例如 "https://graph.microsoft.com/beta/"。

(繼承來源 AuthorizationHeaderProviderOptions)
ContentType

請求主體的內容類型。

(繼承來源 DownstreamApiOptions)
CustomizeHttpRequestMessage

提供來電應用程式自訂 HttpRequestMessage 的機會。 例如,要自訂標頭。 此呼叫會在訊息形成後(包括授權標頭)及訊息發送前執行。

(繼承來源 AuthorizationHeaderProviderOptions)
Deserializer

可選的解串器。 會將 Web API 的輸出(如果有的話)反序列化。 若未提供,則會回傳以下資料: JsonSerializer.Deserialize<TOutput>(content, new JsonSerializerOptions { PropertyNameCaseInsensitive = true });

(繼承來源 DownstreamApiOptions)
ExtraHeaderParameters

在 HTTP 請求中為下游的網頁 API 設置額外的標頭。 這不應與將請求標頭設定為身份提供者的其他選項混淆。 看看 ExtraHeadersParameters 那種情況。

(繼承來源 DownstreamApiOptions)
ExtraQueryParameters

為 HTTP 請求中向下游 Web API 的查詢字串設定查詢參數。 這不應與請求中對身份提供者設定查詢參數的其他選項混淆。 看看 ExtraQueryParameters 那種情況。

(繼承來源 DownstreamApiOptions)
HttpMethod

HTTP 方法只能公開閱讀。

ProtocolScheme

用於建立授權標頭的協定方案名稱。 預設為「承載者」。

(繼承來源 AuthorizationHeaderProviderOptions)
RelativePath

相對於 BaseUrl 路徑(例如「我」)。

(繼承來源 AuthorizationHeaderProviderOptions)
RequestAppToken

描述下游 API 是代表呼叫服務本身(App 標記)還是代表服務處理的使用者(使用者標記)呼叫。 若 true,則代表應用程式請求該令牌。 否則,就是代表使用者。

(繼承來源 AuthorizationHeaderProviderOptions)
Scopes

呼叫下游網頁 API 所需的作用域。 例如「user.read mail.read」。 對於 Microsoft 身份,應用程式權杖(應用程式代表自身請求的權杖)應該只有一個範圍,且以「./default」結尾。

(繼承來源 DownstreamApiOptions)
Serializer

可選的串行器。 會將輸入序列化到網頁 API(如果有的話)。 預設情況下,若未提供:

  • 如果輸入源自 HttpInput,則直接使用
  • 如果輸入是字串,則會使用它,且被視為媒體類型 json。
  • 否則,物件會以 JSON 序列化,使用 UTF8 編碼,並以 application/json 的媒體類型:
    new StringContent(JsonSerializer.Serialize(input), Encoding.UTF8, "application/json")
    
(繼承來源 DownstreamApiOptions)

方法

名稱 Description
Clone()

複製選項

CloneInternal()

複製選項(以便能覆蓋它們)。

GetApiUrl()

回傳下游的網頁 API URL。

(繼承來源 AuthorizationHeaderProviderOptions)

適用於