Binding.CertificateHash Eigenschaft

Referenz

Definition

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

Share via