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
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 | -- |