WSFederationMessage.CreateFromNameValueCollection 方法

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

從參數的 NameValueCollection 建立 WS-Federation 訊息。

public:
 static System::IdentityModel::Services::WSFederationMessage ^ CreateFromNameValueCollection(Uri ^ baseUrl, System::Collections::Specialized::NameValueCollection ^ collection);

public static System.IdentityModel.Services.WSFederationMessage CreateFromNameValueCollection (Uri baseUrl, System.Collections.Specialized.NameValueCollection collection);

static member CreateFromNameValueCollection : Uri * System.Collections.Specialized.NameValueCollection -> System.IdentityModel.Services.WSFederationMessage

Public Shared Function CreateFromNameValueCollection (baseUrl As Uri, collection As NameValueCollection) As WSFederationMessage

參數

baseUrl

Uri

訊息傳送至的基礎 URL。

collection

NameValueCollection

包含訊息之參數的 NameValueCollection。

傳回

WSFederationMessage

所建立的訊息，或者為null（如果無法建立訊息）。

例外狀況

ArgumentNullException

baseUrl 為 null。

-或-

collection 為 null。

WSFederationMessageException

無法辨識參數集合中的 wa 參數。

ArgumentException

登入回應訊息同時具有參數集合中的 wresult 和 wresultptr 參數。 (有效的登入回應訊息會有等於 "wsignin1.0" 的 wa 參數，以及 wresult 或 wresultptr 其中一個參數，但不能同時有這兩者)。

備註

參數集合必須包含 wa 參數的專案，以指定要執行的動作。 如果 wa 專案不是可辨識的動作，則會擲回例外狀況。 參數集合應該包含集合中 wa 參數所指定之訊息類型的適當參數。 方法會根據 wa 參數傳回 的適當實 WSFederationMessage 作。 下表列出 WSFederationMessage 針對各種參數組合所傳回的實作。

傳回的類型	指定的 wa 查詢參數	註解
AttributeRequestMessage	擷取器1.0	--
PseudonymRequestMessage	wpseudo1.0	--
SignInRequestMessage	wsignin1.0	collection 必須包含 wtrealm 或 wreply 參數。 如果 collection 包含 wresult 或 wresultptr 參數，則會傳回登入回應消息 (請參閱下一個數據列) 。
SignInResponseMessage	wsignin1.0	如果 collection 包含 wresult 或 wresultptr 參數，則會傳回 。 只有一個可能存在。 如果兩者都存在，則會擲回例外狀況。
SignOutRequestMessage	wsignout1.0	--
SignOutCleanupRequestMessage	wsignoutcleanup1.0	--