PictureBox.Load メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

PictureBox にイメージを表示します。

オーバーロード

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

Load()

ソース:

PictureBox.cs

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

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

例外

InvalidOperationException

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

注釈

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

警告

リモート イメージが読み込まれるとすぐに、 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

ImageLocation に指定した URL を設定し、指定したイメージを表示します。

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

警告

リモート イメージが読み込まれるとすぐに、 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