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通过 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)

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 参数来访问位于 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