X509CertificateRecipientClientCredential.SetDefaultCertificate Metod

Definition

Namnområde:: System.ServiceModel.Security

Sammansättningar:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Sammansättning:: System.ServiceModel.Primitives.dll

Sammansättning:: System.ServiceModel.dll

Paket:: System.ServiceModel.Primitives v10.0.652802

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Anger standardcertifikatet som ska användas för tjänsten.

Överlagringar

Name	Description
SetDefaultCertificate(String, StoreLocation, StoreName)	Anger standardcertifikatet som ska användas för tjänsten. För bindningar som använder certifikatbaserad meddelandesäkerhet används det här certifikatet för att kryptera meddelanden till tjänsten och förväntas användas av tjänsten för signering av svar till klienten.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Anger standardcertifikatet som ska användas för tjänsten. För bindningar som använder certifikatbaserad meddelandesäkerhet används det här certifikatet för att kryptera meddelanden till tjänsten och förväntas användas av tjänsten för signering av svar till klienten.

Kommentarer

Dessa metoder hämtar ett certifikat från arkivet på den angivna platsen som matchar angivna parametrar.

För bindningar som använder certifikatbaserad meddelandesäkerhet används det här certifikatet för att kryptera meddelanden till tjänsten och förväntas användas av tjänsten för signering av svar till klienten.

SetDefaultCertificate(String, StoreLocation, StoreName)

Källa:: X509CertificateRecipientClientCredential.cs

Källa:: X509CertificateRecipientClientCredential.cs

Källa:: X509CertificateRecipientClientCredential.cs

Anger standardcertifikatet som ska användas för tjänsten. För bindningar som använder certifikatbaserad meddelandesäkerhet används det här certifikatet för att kryptera meddelanden till tjänsten och förväntas användas av tjänsten för signering av svar till klienten.

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)

Parametrar

subjectName: String

Ämnets unika namn.

storeLocation: StoreLocation

Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.

storeName: StoreName

Namnet på X.509-certifikatarkivet som ska öppnas.

Undantag

ArgumentNullException

subjectName är null.

InvalidOperationException

Försökte ange när autentiseringsuppgifterna är skrivskyddade.

Exempel

Följande kod använder den här metoden för att ange ett X.509-certifikat som ska användas.

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

Kommentarer

Den här metoden hämtar ett certifikat från arkivet på den angivna platsen som matchar parametern subjectName .

Värden för storeLocation ingår i StoreLocation uppräkningen:

LocalMachine: certifikatarkivet som tilldelats den lokala datorn.
CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).

Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.

Värden för storeName ingår i StoreName uppräkningen.

Gäller för

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Källa:: X509CertificateRecipientClientCredential.cs

Källa:: X509CertificateRecipientClientCredential.cs

Källa:: 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)

Parametrar

storeLocation: StoreLocation

Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.

storeName: StoreName

Namnet på X.509-certifikatarkivet som ska öppnas.

findType: X509FindType

Typen av X.509-sökning som ska köras.

findValue: Object

Värdet att söka efter i X.509-certifikatarkivet.

Undantag

ArgumentNullException

findValue är null.

InvalidOperationException

Försökte ange när autentiseringsuppgifterna är skrivskyddade.

Exempel

Följande kod använder den här metoden för att ange ett X.509-certifikat som ska användas.

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

Kommentarer

Den här metoden hämtar ett certifikat från arkivet på den angivna platsen som matchar parametrarna findType och findValue .

Värden för storeLocation ingår i StoreLocation uppräkningen:

LocalMachine: certifikatarkivet som tilldelats den lokala datorn.
CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).

Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.

Värden för storeName ingår i StoreName uppräkningen.

Värden för findType ingår i X509FindType uppräkningen.

Den vanligaste uppräkningen är FindBySubjectName, som gör en skiftlägeskänslig sökning på certifikatets ämnesnamn i det angivna arkivet. Detta kan vara en oprecis sökning. Om inga certifikat eller flera certifikat som matchar kriterierna hittas genereras ett InvalidOperationException .

Gäller för

Feedback

Var den här sidan till hjälp?