WSFederationMessage.CreateFromNameValueCollection Methode

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Erstellt eine WS-Verbund-Meldung aus einer NameValueCollection von Parametern.

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

Parameter

baseUrl

Uri

Die Basis-URL für die Verbund-Nachricht ist beabsichtigt.

collection

NameValueCollection

Eine NameValueCollection, die die Parameter für die Nachricht enthält.

Gibt zurück

WSFederationMessage

Die Meldung, die erstellt wurde, oder null, wenn eine Nachricht nicht erstellt werden kann.

Ausnahmen

ArgumentNullException

baseUrl ist null.

- oder -

collection ist null.

WSFederationMessageException

Der wa-Parameter in der Parameterauflistung wurde nicht erkannt.

ArgumentException

Eine Anmeldungsantwortnachricht hat die wresult- und wresultptr-Parameter in der Parametersammlung. (Eine gültige Anmeldungsantwortmeldung verfügt über den „wa“-Parameter, der gleich „wsignin1.0“ und entweder gleich „wresult“- oder „wresultptr“-Parameter ist, aber nicht beide.)

Hinweise

Die Parameterauflistung muss einen Eintrag für den wa-Parameter enthalten, der die auszuführende Aktion angibt. Wenn der wa-Eintrag keine erkannte Aktion ist, wird eine Ausnahme ausgelöst. Die Parameterauflistung sollte geeignete Parameter für die Art der Nachricht enthalten, die vom wa-Parameter in der Auflistung angegeben wird. Die -Methode gibt basierend auf dem wa-Parameter eine geeignete Implementierung von WSFederationMessage zurück. In der folgenden Tabelle ist die WSFederationMessage für verschiedene Parameterkombinationen zurückgegebene Implementierung aufgeführt.

Zurückgegebener Typ	wa-Abfrageparameter angegeben	Kommentare
AttributeRequestMessage	wattr1.0	--
PseudonymRequestMessage	wpseudo1.0	--
SignInRequestMessage	wsignin1.0	collection muss entweder einen wtrealm- oder einen wreply-Parameter enthalten. Wenn collection ein wresult- oder wresultptr-Parameter enthält, wird eine Anmeldeantwortmeldung zurückgegeben (siehe nächste Zeile).
SignInResponseMessage	wsignin1.0	Wird zurückgegeben, wenn collection einen wresult- oder wresultptr-Parameter enthält. Es darf nur eine vorhanden sein. Wenn beide vorhanden sind, wird eine Ausnahme ausgelöst.
SignOutRequestMessage	wsignout1.0	--
SignOutCleanupRequestMessage	wsignoutcleanup1.0	--