Поделиться через

PictureBox.Load Метод

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Отображает изображение в элементе PictureBox.

Перегрузки

Имя Описание
Load()

Отображает изображение, указанное свойством ImageLocation объекта PictureBox.
Load(String)

ImageLocation Задает указанный URL-адрес и отображает указанное изображение.

Load()

Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
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.

Ранее работающий удаленный ресурс может не загружаться, если локально кэшированный список отзыва сертификатов устарел и обновление не может быть получено. Это может произойти, если сеть, в которую запущено приложение, ограничено, и расположение списка разрешений не находится в списке разрешений.

Кроме того, возможно, задержка при проверке списка отзыва сертификатов негативно влияет на способность приложения функционировать.

Вы можете отказаться от этого поведения, задав System.Windows.Forms.ServicePointManagerCheckCrl параметр для приложения одним из следующих способов:

  • Задайте для свойства false значение в файле конфигурации [app].runtimeconfig.json :

    {
  "configProperties": {
    "System.Windows.Forms.ServicePointManagerCheckCrl": false
  }
}

  • <RuntimeHostConfigurationOption> Добавьте элемент в файл проекта, чтобы отключить его:

    <ItemGroup>
  <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
</ItemGroup>

См. также раздел

Применяется к

Load(String)

Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
PictureBox.cs
Исходный код:
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 ссылается на изображение в Интернете, к которому не удается получить доступ.

ArgumentException

url ссылается на файл, который не является изображением.

FileNotFoundException

url ссылается на файл, который не существует.

Комментарии

url Если параметр указывает локальный файл, рекомендуемый формат — это локальный путь к файлу. Например, к файлу изображения с именемmyPicture.jpg , расположенному в c:\ , будет предоставлен доступ путем передачи 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.

Ранее работающий удаленный ресурс может не загружаться, если локально кэшированный список отзыва сертификатов устарел и обновление не может быть получено. Это может произойти, если сеть, в которую запущено приложение, ограничено, и расположение списка разрешений не находится в списке разрешений.

Кроме того, возможно, задержка при проверке списка отзыва сертификатов негативно влияет на способность приложения функционировать.

Вы можете отказаться от этого поведения, задав System.Windows.Forms.ServicePointManagerCheckCrl параметр для приложения одним из следующих способов:

  • Задайте для свойства false значение в файле конфигурации [app].runtimeconfig.json :

    {
  "configProperties": {
    "System.Windows.Forms.ServicePointManagerCheckCrl": false
  }
}

  • <RuntimeHostConfigurationOption> Добавьте элемент в файл проекта, чтобы отключить его:

    <ItemGroup>
  <RuntimeHostConfigurationOption Include="System.Windows.Forms.ServicePointManagerCheckCrl" Value="false" />
</ItemGroup>

См. также раздел

Применяется к