X509CertificateRecipientClientCredential.SetScopedCertificate 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.

Define um certificado de um repositório e o armazena em uma coleção indexada pela URL que define o escopo.

Sobrecargas

Nome	Description
SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Define um certificado por nome da entidade, local do repositório de certificados e nome do repositório de certificados e o armazena em uma coleção a ser usada para a URL que define o escopo.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Define um certificado por local do repositório de certificados, nome do repositório de certificados, tipo de pesquisa X.509 e valor a ser pesquisado e o armazena em uma coleção a ser usada para a URL que define o escopo.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Define um certificado por nome da entidade, local do repositório de certificados e nome do repositório de certificados e o armazena em uma coleção a ser usada para a URL que define o escopo.

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

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

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

Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)

Parâmetros

subjectName: String

O nome da entidade totalmente qualificada.

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.

targetService: Uri

A URL que define o escopo.

Exceções

ArgumentNullException

subjectName ou targetService é null.

InvalidOperationException

Tentou definir quando a credencial é somente leitura.

Exemplos

Este código mostra como chamar esse método.

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

Comentários

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

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Origem:: X509CertificateRecipientClientCredential.cs

Define um certificado por local do repositório de certificados, nome do repositório de certificados, tipo de pesquisa X.509 e valor a ser pesquisado e o armazena em uma coleção a ser usada para a URL que define o escopo.

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

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

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

Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)

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.

targetService: Uri

A URL que define o escopo.

Exceções

ArgumentNullException

findValue ou targetService é null.

InvalidOperationException

Tentou definir quando a credencial é somente leitura.

Exemplos

Este código mostra como chamar esse método.

public void snippet20(CalculatorClient client)
{
    X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS",
                             new Uri("http://fabrikam.com/sts"));
}

rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
            StoreName.TrustedPeople, _
            X509FindType.FindBySubjectName, _
            "FabrikamSTS", _
            New Uri("http://fabrikam.com/sts"))

Comentários

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?