WSFederationMessage.CreateFromNameValueCollection Metoda

Definicja

Przestrzeń nazw:

System.IdentityModel.Services

Zestaw:

System.IdentityModel.Services.dll

Tworzy komunikat WS-Federation na podstawie NameValueCollection parametrów.

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

Parametry

baseUrl

Uri

Podstawowy adres URL, do którego ma być przeznaczony komunikat.

collection

NameValueCollection

Element NameValueCollection , który zawiera parametry komunikatu.

Zwraca

WSFederationMessage

Komunikat, który został utworzony lub null jeśli nie można utworzyć komunikatu.

Wyjątki

ArgumentNullException

baseUrl to null.

-lub-

collection to null.

WSFederationMessageException

Parametr wa w kolekcji parametrów nie jest rozpoznawany.

ArgumentException

Komunikat odpowiedzi logowania zawiera zarówno parametr wresult, jak i wresultptr w kolekcji parametrów. (Prawidłowy komunikat odpowiedzi logowania ma parametr wa równy "wsignin1.0" i albo wresult lub wresultptr parametru, ale nie oba).

Uwagi

Kolekcja parametrów musi zawierać wpis parametru wa, który określa akcję do wykonania. Jeśli wpis wa nie jest rozpoznaną akcją, zgłaszany jest wyjątek. Kolekcja parametrów powinna zawierać odpowiednie parametry dla rodzaju komunikatu określonego przez parametr wa w kolekcji. Metoda zwróci odpowiednią implementację WSFederationMessage na podstawie parametru wa. W poniższej tabeli wymieniono implementację zwróconą WSFederationMessage dla różnych kombinacji parametrów.

Zwracany typ	określono parametr zapytania wa	Komentarze
AttributeRequestMessage	wattr1.0	--
PseudonymRequestMessage	wpseudo1.0	--
SignInRequestMessage	wsignin1.0	collection musi zawierać parametr wtrealm lub wreply. Jeśli collection zawiera wresult lub wresultptr parametr, zostanie zwrócony komunikat odpowiedzi logowania (zobacz następny wiersz).
SignInResponseMessage	wsignin1.0	Zwracany, jeśli collection zawiera parametr wresult lub wresultptr. Tylko jeden może być obecny. Jeśli oba są obecne, zgłaszany jest wyjątek.
SignOutRequestMessage	wsignout1.0	--
SignOutCleanupRequestMessage	wsignoutcleanup1.0	--