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 свойство имеет значение 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>
  

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

• LoadAsync

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 ссылается на недоступное в Интернете изображение.

ArgumentException

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

FileNotFoundException

url ссылается на несуществующий файл.

Комментарии

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

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

• ImageLocation