PictureBox.Load メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

PictureBoxに画像を表示します。

オーバーロード

名前	説明
Load()	PictureBoxのImageLocation プロパティで指定されたイメージを表示します。
Load(String)	指定した URL に ImageLocation を設定し、示された画像を表示します。

Load()

ソース:

PictureBox.cs

PictureBoxのImageLocation プロパティで指定されたイメージを表示します。

public:
 void Load();

public void Load();

member this.Load : unit -> unit

Public Sub Load ()

例外

InvalidOperationException

ImageLocation が null または空の文字列です。

注釈

.NET 8 以降では、 PictureBox コントロールがリモート イメージを読み込む方法の動作が変更されました。 既定では、リモート イメージが WebClient 経由でダウンロードされる前に、System.Net.ServicePointManager.CheckCertificateRevocationList プロパティが true に設定されます。 この設定により、証明書を持つサーバーで、検証プロセスの一環として証明機関失効リスト (CRL) に対してこれらの証明書がチェックされます。

Warnung

リモート イメージが読み込まれるとすぐに、アプリの有効期間中、 CheckCertificateRevocationList が true に変更されます。 必要に応じて手動で false に戻すことができますが、別のリモート イメージが読み込まれるとすぐに、 CheckCertificateRevocationList は trueに設定されます。

ローカルにキャッシュされた CRL が古く、更新プログラムを取得できない場合、以前に動作していたリモート リソースの読み込みに失敗する可能性があります。 これは、アプリが実行されているネットワークが制限されていて、CRL の場所が許可リストにない場合に発生する可能性があります。

CRL のチェックの遅延がアプリの機能に悪影響を与える可能性もあります。

この動作を無効にするには、次のいずれかの方法でアプリの System.Windows.Forms.ServicePointManagerCheckCrl オプションを設定します。

• [app] .runtimeconfig.json構成ファイルでプロパティをfalseに設定します。

  {
    "configProperties": {
      "System.Windows.Forms.ServicePointManagerCheckCrl": false
    }
  }
  

• プロジェクト ファイルに <RuntimeHostConfigurationOption> 項目を追加して無効にします。

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
  </ItemGroup>
  

こちらもご覧ください

• LoadAsync

Load(String)

ソース:

PictureBox.cs

指定した URL に ImageLocation を設定し、示された画像を表示します。

public:
 void Load(System::String ^ url);

public void Load(string url);

member this.Load : string -> unit

Public Sub Load (url As String)

パラメーター

url

String

PictureBoxに表示するイメージのパス。

例外

InvalidOperationException

url が null または空の文字列です。

WebException

url は、アクセスできない Web 上のイメージを参照します。

ArgumentException

url は、イメージではないファイルを参照します。

FileNotFoundException

url は、存在しないファイルを参照します。

注釈

url パラメーターがローカル ファイルを示す場合、推奨される形式はローカル ファイル パスです。 たとえば、c:\ にあるmyPicture.jpg という名前のイメージ ファイルにアクセスするには、url パラメーターにc:\myPicture.jpgを渡します。 http://www.contoso.com/path/images/image.jpgなどの完全なパス、または ./images/image.jpgなどの相対パスを使用できます。 相対パスを使用する場合は、作業ディレクトリに対する相対パスと見なされます。 Load メソッドを呼び出すと、ImageLocation プロパティが url パラメーターの値に設定されます。

読み込み動作の変更

.NET 8 以降では、 PictureBox コントロールがリモート イメージを読み込む方法の動作が変更されました。 既定では、リモート イメージが WebClient 経由でダウンロードされる前に、System.Net.ServicePointManager.CheckCertificateRevocationList プロパティが true に設定されます。 この設定により、証明書を持つサーバーで、検証プロセスの一環として証明機関失効リスト (CRL) に対してこれらの証明書がチェックされます。

Warnung

リモート イメージが読み込まれるとすぐに、アプリの有効期間中、 CheckCertificateRevocationList が true に変更されます。 必要に応じて手動で false に戻すことができますが、別のリモート イメージが読み込まれるとすぐに、 CheckCertificateRevocationList は trueに設定されます。

ローカルにキャッシュされた CRL が古く、更新プログラムを取得できない場合、以前に動作していたリモート リソースの読み込みに失敗する可能性があります。 これは、アプリが実行されているネットワークが制限されていて、CRL の場所が許可リストにない場合に発生する可能性があります。

CRL のチェックの遅延がアプリの機能に悪影響を与える可能性もあります。

この動作を無効にするには、次のいずれかの方法でアプリの System.Windows.Forms.ServicePointManagerCheckCrl オプションを設定します。

• [app] .runtimeconfig.json構成ファイルでプロパティをfalseに設定します。

  {
    "configProperties": {
      "System.Windows.Forms.ServicePointManagerCheckCrl": false
    }
  }
  

• プロジェクト ファイルに <RuntimeHostConfigurationOption> 項目を追加して無効にします。

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
  </ItemGroup>
  

こちらもご覧ください

• ImageLocation