Freigeben über


Binding.CertificateHash Eigenschaft

Definition

Ruft den Hash des zu bindenden Zertifikats ab oder legt diesen fest.

public:
 property cli::array <System::Byte> ^ CertificateHash { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
public byte[] CertificateHash { get; set; }
member this.CertificateHash : byte[] with get, set
Public Property CertificateHash As Byte()

Eigenschaftswert

Byte[]

Das Bytearray, das den SSL-Bindungshash (Secure Sockets Layer) darstellt.

Beispiele

Im folgenden Beispiel wird die CertificateHash -Eigenschaft veranschaulicht. Wenn der Protokollbezeichner "https" lautet, werden der Zertifikathash und der Name des Zertifikatspeichers angezeigt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Binding-Klasse bereitgestellt wird.

if (binding.Protocol == "https")
{
     // There is a CertificateHash and  
     // CertificateStoreName for the https protocol only.
    bindingdisplay = bindingdisplay + "\n   CertificateHash: " + 
        binding.CertificateHash + ": ";
    // Display the hash.
    foreach (System.Byte certhashbyte in binding.CertificateHash)
    {
        bindingdisplay = bindingdisplay + certhashbyte.ToString() + " ";
    }
    bindingdisplay = bindingdisplay + "\n   CertificateStoreName: " + 
        binding.CertificateStoreName;
}

Hinweise

Die CertificateHash -Eigenschaft enthält den Zertifikathash für die SSL-Bindung. Der Zertifikathash ist der eindeutige Bezeichner für das Zertifikat.

Die CertificateHash -Eigenschaft ist nur verfügbar, wenn der von der Protocol -Eigenschaft definierte Protokollbezeichner "https" lautet. Ein Versuch, die CertificateHash Eigenschaft für eine Bindung mit dem Protokoll "http" abzurufen oder festzulegen, löst einen Fehler aus.

Der Wert der CertificateHash -Eigenschaft wird im BindingCollection -Objekt festgelegt.

Gilt für: