PictureBox.Load 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

顯示 PictureBox.

多載

名稱	Description
Load()	顯示由 ImageLocation 屬性 PictureBox指定的影像。
Load(String)	將 設定 ImageLocation 為指定的網址，並顯示所示圖片。

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 屬性會設定為 true ，在遠端映像檔下載之前 WebClient。 此設定確保擁有憑證的伺服器在驗證過程中會被與憑證授權中心撤銷清單（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 為指定的網址，並顯示所示圖片。

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 指的是網路上無法存取的圖片。

ArgumentException

url 指的是一個不是影像的檔案。

FileNotFoundException

url 指的是不存在的檔案。

備註

若參數 url 表示本地檔案，建議格式為本地檔案路徑。 例如，位於 c：\ 的影像檔案 myPicture.jpg 可透過傳遞c:\myPicture.jpgurl參數來存取。 可以使用完整路徑，例如 http://www.contoso.com/path/images/image.jpg，或相對路徑，例如 ./images/image.jpg，。 若使用相對路徑，則會視為相對於工作目錄的路徑。 呼叫該 Load 方法會將屬性設定 ImageLocation 為參數的 url 值。

負載行為的變化

從 .NET 8 開始，控制器載入遠端映像的行為 PictureBox 改變了。 預設情況下，該 System.Net.ServicePointManager.CheckCertificateRevocationList 屬性會設定為 true ，在遠端映像檔下載之前 WebClient。 此設定確保擁有憑證的伺服器在驗證過程中會被與憑證授權中心撤銷清單（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