ServicePointManager.CertificatePolicy プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ServicePointManager.CertificatePolicy プロパティ

メモ : このプロパティは、互換性のために残されています。

サーバーの証明書ポリシーを取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim value As ICertificatePolicy

value = ServicePointManager.CertificatePolicy

ServicePointManager.CertificatePolicy = value

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

C++

[ObsoleteAttribute(L"CertificatePolicy is obsoleted for this
 type, please use ServerCertificateValidationCallback instead. http://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)

JScript

public static function get
 CertificatePolicy () : ICertificatePolicy

public static function set
 CertificatePolicy (value : ICertificatePolicy)

プロパティ値
ICertificatePolicy インターフェイスを実装するオブジェクト。

解説

CertificatePolicy プロパティが ICertificatePolicy インターフェイスオブジェクトに設定されている場合、ServicePointManager オブジェクトは、既定の証明書ポリシーではなく、そのインスタンスで定義されている証明書ポリシーを使用します。

既定の証明書ポリシーでは有効な証明書が許可されますが、有効であれば期限が切れている証明書でも許可されてしまいます。

使用例

カスタム証明書ポリシーの証明書ポリシー例外をキャッチする方法を次のコード例に示します。この例では、証明書ポリシーオブジェクトが定義され、Web リソースの URI (Uniform Resource Identifier) が変数 myUri に格納され、アプリケーションの作業を実行する ProcessResponse というメソッドが存在することを前提としています。

Visual Basic

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
       }

C++

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
}