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


PictureBox.Load Метод

Определение

Отображает изображение в объекте 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 ()

Исключения

Параметр 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)

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

Исключения

Параметр url имеет значение null или является пустой строкой.

url ссылается на недоступное в Интернете изображение.

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

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>
    

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

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