PictureBox.Load 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

在 PictureBox 中顯示影像。

多載

Load()

顯示 ImageLocation 的 PictureBox 屬性所指定的影像。
Load(String)

將 ImageLocation 設定為指定的 URL，並顯示所表示的影像。

Load()

顯示 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>

另請參閱

適用於

Load(String)

將 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 參數，即可存取名為 myPicture.jpgmyPicture.jpg的url映像檔。 可以使用完整路徑，例如 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>

另請參閱

適用於