X509CertificateRecipientClientCredential.SetScopedCertificate Método

Definición

Espacio de nombres:

System.ServiceModel.Security

Ensamblado:

System.ServiceModel.Primitives.dll

Ensamblado:

System.ServiceModel.dll

Establece un certificado de un almacén y lo almacena en una colección indizada por la dirección URL que establece el ámbito.

Sobrecargas

SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Establece un certificado por nombre de asunto, la ubicación del almacén de certificados, el nombre del almacén de certificados y lo almacena en una colección que se va a usar para la dirección URL que establece el ámbito.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Establece un certificado por ubicación del almacén de certificados, el nombre del almacén de certificados, el tipo de búsqueda de X.509, el valor que se va a buscar y lo almacena en una colección que se va a usar para la dirección URL que establece el ámbito.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Establece un certificado por nombre de asunto, la ubicación del almacén de certificados, el nombre del almacén de certificados y lo almacena en una colección que se va a usar para la dirección URL que establece el ámbito.

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

El nombre del asunto debe ser completo.

storeLocation

StoreLocation

La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado del servicio.

storeName

StoreName

Obtiene el nombre del almacén de certificados X.509.

targetService

Uri

La dirección URL que establece el ámbito.

Excepciones

ArgumentNullException

subjectName o targetService es null.

InvalidOperationException

Se intentó establecer cuando la credencial es de solo lectura.

Ejemplos

Este código muestra cómo llamar a este 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"));
}

Comentarios

Los valores para storeLocation están incluidos en la enumeración StoreLocation:

• LocalMachine: el almacén de certificados asignado al equipo local.

• CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).

Si la aplicación se está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.

Los valores para storeName están incluidos en la enumeración StoreName.

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

Establece un certificado por ubicación del almacén de certificados, el nombre del almacén de certificados, el tipo de búsqueda de X.509, el valor que se va a buscar y lo almacena en una colección que se va a usar para la dirección URL que establece el ámbito.

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

La ubicación del almacén de certificados que el servicio utiliza para obtener el certificado del servicio.

storeName

StoreName

Obtiene el nombre del almacén de certificados X.509.

findType

X509FindType

El tipo de búsqueda de X.509 que se va a ejecutar.

findValue

Object

El valor que se va a buscar en el almacén de certificados X.509.

targetService

Uri

La dirección URL que establece el ámbito.

Excepciones

ArgumentNullException

findValue o targetService es null.

InvalidOperationException

Se intentó establecer cuando la credencial es de solo lectura.

Ejemplos

Este código muestra cómo llamar a este 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"))

Comentarios

Los valores para storeLocation están incluidos en la enumeración StoreLocation:

• LocalMachine: el almacén de certificados asignado al equipo local.

• CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).

Si la aplicación se está ejecutando bajo una cuenta del sistema, entonces el certificado está normalmente en LocalMachine. Si la aplicación se está ejecutando en una cuenta de usuario, entonces el certificado se encuentra normalmente en CurrentUser.

Los valores para storeName están incluidos en la enumeración StoreName.

Los valores para findType están incluidos en la enumeración X509FindType.

La enumeración normalmente utilizada es FindBySubjectName, que hace una búsqueda sin distinción entre mayúsculas y minúsculas en el nombre del asunto de certificados en el almacén especificado. Ésta puede ser una búsqueda imprecisa. Si ningún certificado o varios certifica que coinciden los criterios que se buscan, se producirá InvalidOperationException.