WSFederationMessage.CreateFromNameValueCollection(Uri, NameValueCollection) Método

Definição

Cria uma mensagem do Web Services Federation usando uma NameValueCollection de parâmetros.Creates a WS-Federation message from a NameValueCollection of parameters.

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

Parâmetros

baseUrl
Uri

A URL base à qual se destina a mensagem.The base URL to which the message is intended.

collection
NameValueCollection

A NameValueCollection que contém os parâmetros da mensagem.The NameValueCollection that contains the parameters for the message.

Retornos

WSFederationMessage

A mensagem que foi criada ou null se uma mensagem não puder ser criada.The message that was created or null if a message cannot be created.

Exceções

baseUrl é null.baseUrl is null.

- ou --or- collection é null.collection is null.

O parâmetro wa na coleção de parâmetros não é reconhecido.The wa parameter in the parameter collection is not recognized.

Uma mensagem de resposta de entrada tem os parâmetros wresult e wresultptr na coleção de parâmetros.A sign-in response message has both the wresult and wresultptr parameter in the parameter collection. (Uma mensagem de resposta de entrada válida tem o parâmetro wa igual a "wsignin1.0" e o parâmetro wresult ou wresultptr, mas não ambos.)(A valid sign-in response message has the wa parameter equal to "wsignin1.0" and either the wresult or the wresultptr parameter, but not both.)

Comentários

A coleção de parâmetros deve conter uma entrada para o parâmetro wa, que especifica a ação a ser executada.The parameter collection must contain an entry for the wa parameter, which specifies the action to be performed. Se a entrada WA não for uma ação reconhecida, uma exceção será lançada.If the wa entry is not a recognized action, an exception is thrown. A coleção de parâmetros deve conter os parâmetros apropriados para o tipo de mensagem especificado pelo parâmetro wa na coleção.The parameter collection should contain appropriate parameters for the kind of message specified by the wa parameter in the collection. O método retornará uma implementação apropriada do WSFederationMessage com base no parâmetro wa.The method will return an appropriate implementation of WSFederationMessage based on the wa parameter. A tabela a seguir lista a WSFederationMessage implementação retornada para várias combinações de parâmetros.The following table lists the WSFederationMessage implementation returned for various parameter combinations.

Tipo retornadoType returned parâmetro de consulta wa especificadowa query parameter specified ComentáriosComments
AttributeRequestMessage Watt 1.0wattr1.0 --
PseudonymRequestMessage wpseudo 1.0wpseudo1.0 --
SignInRequestMessage wsignin 1.0wsignin1.0 collection deve conter um parâmetro wtrealm ou Wreply.collection must contain either a wtrealm or a wreply parameter. Se collection contiver um parâmetro os ou wresultptr, uma mensagem de resposta de logon será retornada (consulte a próxima linha).If collection contains a wresult or a wresultptr parameter, a sign-in response message is returned (see next row).
SignInResponseMessage wsignin 1.0wsignin1.0 Retornado se collection contém um parâmetro os ou wresultptr.Returned if collection contains a wresult or wresultptr parameter. Apenas um pode estar presente.Only one may be present. Se ambos estiverem presentes, uma exceção será lançada.If both are present, an exception is thrown.
SignOutRequestMessage wsignout 1.0wsignout1.0 --
SignOutCleanupRequestMessage wsignoutcleanup 1.0wsignoutcleanup1.0 --

Aplica-se a