ServicePointManager.CertificatePolicy-Eigenschaft

HINWEIS: Diese Eigenschaft ist mittlerweile veraltet.

Ruft eine Richtlinie für Serverzertifikate ab oder legt diese fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
<ObsoleteAttribute("CertificatePolicy is obsoleted for this type, please use ServerCertificateValidationCallback instead. https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Shared Property CertificatePolicy As ICertificatePolicy
'Usage
Dim value As ICertificatePolicy

value = ServicePointManager.CertificatePolicy

ServicePointManager.CertificatePolicy = value

[ObsoleteAttribute("CertificatePolicy is obsoleted for this type, please use ServerCertificateValidationCallback instead. https://go.microsoft.com/fwlink/?linkid=14202")] 
public static ICertificatePolicy CertificatePolicy { get; set; }

[ObsoleteAttribute(L"CertificatePolicy is obsoleted for this type, please use ServerCertificateValidationCallback instead. https://go.microsoft.com/fwlink/?linkid=14202")] 
public:
static property ICertificatePolicy^ CertificatePolicy {
    ICertificatePolicy^ get ();
    void set (ICertificatePolicy^ value);
}

/** @property */
public static ICertificatePolicy get_CertificatePolicy ()

/** @property */
public static void set_CertificatePolicy (ICertificatePolicy value)

public static function get CertificatePolicy () : ICertificatePolicy

public static function set CertificatePolicy (value : ICertificatePolicy)

Eigenschaftenwert

Ein Objekt, das die ICertificatePolicy-Schnittstelle implementiert.

Hinweise

Wenn die CertificatePolicy-Eigenschaft auf ein ICertificatePolicy-Schnittstellenobjekt festgelegt wird, verwendet das ServicePointManager-Objekt nicht die Standardzertifikatsrichtlinie, sondern die in dieser Instanz definierte Zertifikatsrichtlinie.

Die Standardzertifikatsrichtlinie lässt gültige Zertifikate und gültige, abgelaufene Zertifikate zu.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie eine Zertifikatsrichtlinienausnahme für eine benutzerdefinierte Zertifikatsrichtlinie abgefangen werden kann. Es wird vorausgesetzt, dass das Zertifikatsrichtlinienobjekt definiert wurde, dass die Variable myUri den URI (Uniform Resource Identifier) für die Webressource enthält und dass eine Methode mit dem Namen ProcessResponse vorhanden ist, die die Arbeit der Anwendung ausführt.

ServicePointManager.CertificatePolicy = New MyCertificatePolicy()
       
' Create the request and receive the response
Try
    Dim myRequest As WebRequest = WebRequest.Create(myUri)
    Dim myResponse As WebResponse = myRequest.GetResponse()
    
    ProcessResponse(myResponse)

    myResponse.Close()
    
' Catch any exceptions
Catch e As WebException
    If e.Status = WebExceptionStatus.TrustFailure Then
        ' Code for handling security certificate problems goes here.
    End If
    ' Other exception handling goes here
 End Try

ServicePointManager.CertificatePolicy = new MyCertificatePolicy();
 
       // Create the request and receive the response
       try
       {
       WebRequest myRequest = WebRequest.Create(myUri);
       WebResponse myResponse = myRequest.GetResponse();
       ProcessResponse(myResponse);
       myResponse.Close();
       }
       // Catch any exceptions
       catch(WebException e)
       {
       if (e.Status == WebExceptionStatus.TrustFailure)
       {
       // Code for handling security certificate problems goes here.
       }
       // Other exception handling goes here
       }
   

ServicePointManager::CertificatePolicy = gcnew MyCertificatePolicy;

// Create the request and receive the response
try
{
   WebRequest^ myRequest = WebRequest::Create( myUri );
   WebResponse^ myResponse = myRequest->GetResponse();
   ProcessResponse( myResponse );
   myResponse->Close();
}
// Catch any exceptions
catch ( WebException^ e ) 
{
   if ( e->Status == WebExceptionStatus::TrustFailure )
   {
      // Code for handling security certificate problems goes here.
   }
   // Other exception handling goes here
}

ServicePointManager.set_CertificatePolicy(new MyCertificatePolicy());

// Create the request and receive the response
try {
    WebRequest myRequest = WebRequest.Create(myUri);
    WebResponse myResponse = myRequest.GetResponse();
    ProcessResponse(myResponse);
    myResponse.Close();
}
// Catch any exceptions
catch (WebException e) {
    if (e.get_Status() == WebExceptionStatus.TrustFailure) {
        // Code for handling security certificate problems goes here.
    }
    // Other exception handling goes here
}

.NET Framework-Sicherheit

• SecurityPermission  zum Festlegen der CertificatePolicy-Eigenschaft. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

.NET Compact Framework

Unterstützt in: 1.0
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

ServicePointManager-Klasse
ServicePointManager-Member
System.Net-Namespace