X509CertificateRecipientClientCredential.SetDefaultCertificate Método

Definição

Espaço de Nomes:: System.ServiceModel.Security

Assemblagens:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assemblagem:: System.ServiceModel.Primitives.dll

Assemblagem:: System.ServiceModel.dll

Pacote:: System.ServiceModel.Primitives v10.0.652802

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Especifica o certificado padrão a usar para o serviço.

Sobrecargas

Name	Description
SetDefaultCertificate(String, StoreLocation, StoreName)	Especifica o certificado padrão a usar para o serviço. Para ligações que utilizam segurança de mensagens baseada em certificado, este certificado é usado para encriptar mensagens para o serviço e espera-se que seja utilizado pelo serviço para assinar respostas ao cliente.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Especifica o certificado padrão a usar para o serviço. Para ligações que utilizam segurança de mensagens baseada em certificado, este certificado é usado para encriptar mensagens para o serviço e espera-se que seja utilizado pelo serviço para assinar respostas ao cliente.

Observações

Estes métodos recebem um certificado da loja na localização especificada que corresponde a parâmetros especificados.

Para ligações que utilizam segurança de mensagens baseada em certificado, este certificado é usado para encriptar mensagens para o serviço e espera-se que seja utilizado 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 usar para o serviço. Para ligações que utilizam segurança de mensagens baseada em certificado, este certificado é usado para encriptar mensagens para o serviço e espera-se que seja utilizado 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 sujeito distinguiu o nome.

storeLocation: StoreLocation

A localização do armazenamento de certificados que o serviço utiliza para obter o certificado de serviço.

storeName: StoreName

O nome da loja de certificados X.509 a abrir.

Exceções

ArgumentNullException

subjectName é null.

InvalidOperationException

Tentei definir quando a credencial é apenas leitura.

Exemplos

O código seguinte utiliza este método para especificar um certificado X.509 a utilizar.

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

Observações

Este método recebe um certificado da loja na localização especificada que corresponde ao subjectName parâmetro.

Os valores para storeLocation são incluídos na StoreLocation enumeração:

LocalMachine: o armazenamento de certificados atribuído à máquina local.
CurrentUser: o armazenamento de certificados usado pelo utilizador atual (por defeito).

Se a aplicação estiver a correr sob uma conta do sistema, então o certificado está normalmente em LocalMachine. Se a aplicação estiver a correr sob uma conta de utilizador, então o certificado está tipicamente em CurrentUser.

Os valores para storeName sã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

A localização do armazenamento de certificados que o serviço utiliza para obter o certificado de serviço.

storeName: StoreName

O nome da loja de certificados X.509 a abrir.

findType: X509FindType

O tipo de pesquisa X.509 a ser executada.

findValue: Object

O valor a procurar na loja de certificados X.509.

Exceções

ArgumentNullException

findValue é null.

InvalidOperationException

Tentei definir quando a credencial é apenas leitura.

Exemplos

O código seguinte utiliza este método para especificar um certificado X.509 a utilizar.

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

Observações

Este método obtém um certificado da loja na localização especificada que corresponde aos findType parâmetros e findValue .

Os valores para storeLocation são incluídos na StoreLocation enumeração:

LocalMachine: o armazenamento de certificados atribuído à máquina local.
CurrentUser: o armazenamento de certificados usado pelo utilizador atual (por defeito).

Os valores para storeName são incluídos na StoreName enumeração.

Os valores para findType são incluídos na X509FindType enumeração.

A enumeração mais utilizada é FindBySubjectName, que faz uma pesquisa insensível a maiúsculas minúsculas no nome do assunto dos certificados no armazenamento especificado. Esta pode ser uma pesquisa imprecisa. Se não forem encontrados certificados ou múltiplos certificados que correspondam aos critérios, um InvalidOperationException é lançado.

Aplica-se a

Comentários

Esta página foi útil?