X509CertificateRecipientClientCredential.SetDefaultCertificate Método

Definição

Namespace:: System.ServiceModel.Security

Assemblies:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Pacote:: System.ServiceModel.Primitives v10.0.652802

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica o certificado padrão a ser usado para o serviço.

Sobrecargas

Nome	Description
SetDefaultCertificate(String, StoreLocation, StoreName)	Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseadas em certificado, esse certificado é usado para criptografar mensagens no serviço e deve ser usado pelo serviço para assinar respostas ao cliente.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseadas em certificado, esse certificado é usado para criptografar mensagens no serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

Comentários

Esses métodos obtêm um certificado do repositório no local especificado que corresponde aos parâmetros especificados.

Para associações que usam a segurança de mensagens baseadas em certificado, esse certificado é usado para criptografar mensagens no serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

SetDefaultCertificate(String, StoreLocation, StoreName)

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Especifica o certificado padrão a ser usado para o serviço. Para associações que usam a segurança de mensagens baseadas em certificado, esse certificado é usado para criptografar mensagens no serviço e deve ser usado pelo serviço para assinar respostas ao cliente.

public:
 void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);

public void SetDefaultCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);

member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit

Public Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

Parâmetros

subjectName: String

O nome diferenciado do assunto.

storeLocation: StoreLocation

O local do repositório de certificados que o serviço usa para obter o certificado de serviço.

storeName: StoreName

O nome do repositório de certificados X.509 a ser aberto.

Exceções

ArgumentNullException

subjectName é null.

InvalidOperationException

Tentou definir quando a credencial é somente leitura.

Exemplos

O código a seguir usa esse método para especificar um certificado X.509 a ser usado.

public void snippet23(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople);
}

Comentários

Esse método obtém um certificado do repositório no local especificado que corresponde ao subjectName parâmetro.

Os valores para storeLocation os quais estão incluídos na StoreLocation enumeração:

LocalMachine: o repositório de certificados atribuído ao computador local.
CurrentUser: o repositório de certificados usado pelo usuário atual (padrão).

Se o aplicativo estiver em execução em uma conta do sistema, o certificado normalmente estará em LocalMachine. Se o aplicativo estiver em execução em uma conta de usuário, o certificado normalmente estará em CurrentUser.

Os valores para storeName os quais estão incluídos na StoreName enumeração.

Aplica-se a

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

public:
 void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);

public void SetDefaultCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);

member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit

Public Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

Parâmetros

storeLocation: StoreLocation

O local do repositório de certificados que o serviço usa para obter o certificado de serviço.

storeName: StoreName

O nome do repositório de certificados X.509 a ser aberto.

findType: X509FindType

O tipo de pesquisa X.509 a ser executada.

findValue: Object

O valor a ser pesquisado no repositório de certificados X.509.

Exceções

ArgumentNullException

findValue é null.

InvalidOperationException

Tentou definir quando a credencial é somente leitura.

Exemplos

O código a seguir usa esse método para especificar um certificado X.509 a ser usado.

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

Comentários

Esse método obtém um certificado do repositório no local especificado que corresponde aos parâmetros e findType aos findValue parâmetros.

Os valores para storeLocation os quais estão incluídos na StoreLocation enumeração:

LocalMachine: o repositório de certificados atribuído ao computador local.
CurrentUser: o repositório de certificados usado pelo usuário atual (padrão).

Os valores para storeName os quais estão incluídos na StoreName enumeração.

Os valores para findType os quais estão incluídos na X509FindType enumeração.

A enumeração mais usada é FindBySubjectName, que faz uma pesquisa que não diferencia maiúsculas de minúsculas no nome da entidade dos certificados no repositório especificado. Essa pode ser uma pesquisa imprecisa. Se nenhum certificado ou vários certificados que correspondem aos critérios forem encontrados, um InvalidOperationException será gerado.

Aplica-se a

Comentários

Esta página foi útil?