X509CertificateRecipientClientCredential.SetScopedCertificate Método

Referência

Definição

Namespace:: System.ServiceModel.Security

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

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 por URL que define o escopo.

Sobrecargas

SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Define um certificado pelo 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 pela URL que define o escopo.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Define um certificado pelo local do repositório de certificados, pelo nome do repositório de certificados, pelo tipo de pesquisa X.509 e pelo valor a pesquisar e o armazena em uma coleção a ser usada para a URL que define o escopo.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Define um certificado pelo 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 pela 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 totalmente qualificado da entidade.

storeLocation: StoreLocation

O local do repositório de certificados usado pelo serviço 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

Tentativa de definir quando a credencial é somente leitura.

Exemplos

Esse 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 são storeLocation 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á .LocalMachine Se o aplicativo estiver em execução em uma conta de usuário, o certificado normalmente estará .CurrentUser

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

Aplica-se a

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

Define um certificado pelo local do repositório de certificados, pelo nome do repositório de certificados, pelo tipo de pesquisa X.509 e pelo valor a pesquisar 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 usado pelo serviço 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 de 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

Tentativa de definir quando a credencial é somente leitura.

Exemplos

Esse 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 são storeLocation 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 são storeName incluídos na StoreName enumeração.

Os valores são findType 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 sobre o nome do assunto dos certificados no repositório especificado. 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

Compartilhar via

X509CertificateRecipientClientCredential.SetScopedCertificate Método

Definição

Sobrecargas

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais