Aracılığıyla paylaş

X509CertificateRecipientClientCredential.SetScopedCertificate Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.ServiceModel.Security
Bütünleştirilmiş Kod:
System.ServiceModel.Primitives.dll
Bütünleştirilmiş Kod:
System.ServiceModel.dll

Bir depodan sertifika ayarlar ve kapsamı ayarlayan URL tarafından dizinlenmiş bir koleksiyonda depolar.

Aşırı Yüklemeler

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Konu adına, sertifika deposu konumuna ve sertifika deposu adına göre bir sertifika ayarlar ve kapsamı ayarlayan URL için kullanılacak bir koleksiyonda depolar.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Sertifika deposu konumuna, sertifika deposu adına, X.509 arama türüne ve aranacak değere göre bir sertifika ayarlar ve kapsamı ayarlayan URL için kullanılacak bir koleksiyonda depolar.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Konu adına, sertifika deposu konumuna ve sertifika deposu adına göre bir sertifika ayarlar ve kapsamı ayarlayan URL için kullanılacak bir koleksiyonda depolar.

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)

Parametreler

subjectName
String

Tam konu adı.

storeLocation
StoreLocation

Hizmetin hizmet sertifikasını almak için kullandığı sertifika deposunun konumu.

storeName
StoreName

Açılacak X.509 sertifika deposunun adı.

targetService
Uri

Kapsamı ayarlayan URL.

Özel durumlar

ArgumentNullException

subjectName veya targetService şeklindedir null.

InvalidOperationException

Kimlik bilgisi salt okunur olduğunda ayar yapılmaya çalışıldı.

Örnekler

Bu kod, bu yöntemin nasıl çağrılacaklarını gösterir.

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"));
}

Açıklamalar

değerleri storeLocation numaralandırmaya StoreLocation eklenir:

  • LocalMachine: yerel makineye atanan sertifika deposu.

  • CurrentUser: geçerli kullanıcı tarafından kullanılan sertifika deposu (varsayılan).

Uygulama bir sistem hesabı altında çalışıyorsa, sertifika genellikle içindedir LocalMachine. Uygulama bir kullanıcı hesabı altında çalışıyorsa, sertifika genellikle içindedir CurrentUser.

değerleri storeName sabit listesi içinde StoreName yer alır.

Şunlara uygulanır

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

Sertifika deposu konumuna, sertifika deposu adına, X.509 arama türüne ve aranacak değere göre bir sertifika ayarlar ve kapsamı ayarlayan URL için kullanılacak bir koleksiyonda depolar.

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)

Parametreler

storeLocation
StoreLocation

Hizmetin hizmet sertifikasını almak için kullandığı sertifika deposunun konumu.

storeName
StoreName

Açılacak X.509 sertifika deposunun adı.

findType
X509FindType

Yürütülecek X.509 arama türü.

findValue
Object

X.509 sertifika deposunda aranacak değer.

targetService
Uri

Kapsamı ayarlayan URL.

Özel durumlar

ArgumentNullException

findValue veya targetService şeklindedir null.

InvalidOperationException

Kimlik bilgisi salt okunur olduğunda ayar yapılmaya çalışıldı.

Örnekler

Bu kod, bu yöntemin nasıl çağrılacaklarını gösterir.

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"))

Açıklamalar

değerleri storeLocation numaralandırmaya StoreLocation eklenir:

  • LocalMachine: yerel makineye atanan sertifika deposu.

  • CurrentUser: geçerli kullanıcı tarafından kullanılan sertifika deposu (varsayılan).

Uygulama bir sistem hesabı altında çalışıyorsa, sertifika genellikle içindedir LocalMachine. Uygulama bir kullanıcı hesabı altında çalışıyorsa, sertifika genellikle içindedir CurrentUser.

değerleri storeName sabit listesi içinde StoreName yer alır.

değerleri findType sabit listesi içinde X509FindType yer alır.

En yaygın olarak kullanılan numaralandırma, belirtilen depodaki sertifikaların konu adı üzerinde büyük/küçük harfe duyarlı olmayan bir arama yapan numaralandırmadır FindBySubjectName. Bu, kesin olmayan bir arama olabilir. Ölçütlere uyan sertifika veya birden çok sertifika bulunmazsa, bir InvalidOperationException oluşturulur.

Şunlara uygulanır