PictureBox.Load 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在 . 中 PictureBox显示图像。

重载

名称	说明
Load()	显示由 ImageLocation 该 PictureBox属性指定的图像。
Load(String)	设置 ImageLocation 指定的 URL，并显示指示的图像。

Load()

Source:

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)

Source:

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.jpgurl参数来访问名为 myPicture.jpg的映像文件，该文件位于 c：\ 。 可以使用完整路径（如 http://www.contoso.com/path/images/image.jpg./images/image.jpg）或相对路径。 如果使用相对路径，则会将其视为相对于工作目录。 对Load方法的url调用将ImageLocation属性设置为参数的值。

加载行为更改

从 .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