Partager via


X509CertificateInitiatorServiceCredential.SetCertificate Méthode

Définition

Définit le certificat à utiliser pour chiffrer les messages envoyés au client par le service. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.

Surcharges

SetCertificate(String, StoreLocation, StoreName)

Vous permet de spécifier le certificat à utiliser pour chiffrer les messages pour le client en spécifiant le nom unique du sujet. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Spécifie le certificat à utiliser pour chiffrer les messages pour le client. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.

SetCertificate(String, StoreLocation, StoreName)

Vous permet de spécifier le certificat à utiliser pour chiffrer les messages pour le client en spécifiant le nom unique du sujet. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.

public:
 void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);
public void SetCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);
member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit
Public Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

Paramètres

subjectName
String

Nom unique de l'objet.

storeLocation
StoreLocation

L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat.

storeName
StoreName

Le nom du magasin de certificats X.509 à ouvrir.

Exemples

Le code suivant montre comment utiliser cette méthode pour définir le certificat.

Remarques

Pour plus d'informations sur le paramètre subjectName, consultez SubjectName.

Les valeurs pour storeLocation sont incluses dans l'énumération StoreLocation :

  • LocalMachine : le magasin de certificats assigné à l'ordinateur local (par défaut).

  • CurrentUser : le magasin de certificats utilisé par l'utilisateur actuel.

Si l'application cliente s'exécute sous un compte système, le certificat se trouve généralement dans LocalMachine. Si l'application cliente s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.

Les valeurs pour storeName sont incluses dans l'énumération StoreName.

S’applique à

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

Spécifie le certificat à utiliser pour chiffrer les messages pour le client. Ce paramètre est utilisé uniquement par les liaisons configurées avec le mode d’authentification de sécurité de message MutualCertificateDuplex.

public:
 void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);
public void SetCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);
member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit
Public Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

Paramètres

storeLocation
StoreLocation

L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat.

storeName
StoreName

Le nom du magasin de certificats X.509 à ouvrir.

findType
X509FindType

Le type de recherche X.509 à exécuter.

findValue
Object

Valeur à rechercher dans le magasin de certificats X.509.

Exemples

Le code suivant montre comment utiliser cette méthode pour définir le certificat.

Remarques

Les valeurs pour storeLocation sont incluses dans l'énumération StoreLocation :

  • LocalMachine : le magasin de certificats assigné à l'ordinateur local (par défaut).

  • CurrentUser : le magasin de certificats utilisé par l'utilisateur actuel.

Si l'application s'exécute sous un compte système, le certificat se trouve généralement dans LocalMachine. Si l'application s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.

Les valeurs pour storeName sont incluses dans l'énumération StoreName.

Les valeurs pour findType sont incluses dans l'énumération X509FindType.

L'énumération la plus communément utilisée est FindBySubjectName, qui recherche dans le magasin spécifié (non sensible à la casse) le nom de sujet des certificats. Cette recherche peut être imprécise. Si aucun certificat ou plusieurs certificats qui correspondent aux critères sont trouvés, l'exception InvalidOperationException est levée.

S’applique à