PictureBox.Load Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Exibe uma imagem no PictureBox.

Sobrecargas

Load()	Exibe a imagem especificada pela propriedade ImageLocation do PictureBox.
Load(String)	Define o ImageLocation para a URL especificada e exibe a imagem indicada.

Load()

Origem:

PictureBox.cs

Exibe a imagem especificada pela propriedade ImageLocation do PictureBox.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Exceções

InvalidOperationException

ImageLocation é null ou é uma cadeia de caracteres vazia.

Comentários

A partir do .NET 8, o comportamento de como um PictureBox controle carrega uma imagem remota foi alterado. Por padrão, a System.Net.ServicePointManager.CheckCertificateRevocationList propriedade é definida como true antes de uma imagem remota ser baixada por meio de WebClient. Essa configuração garante que os servidores com certificados tenham esses certificados verificados na CRL (lista de revogação de autoridade de certificação) como parte do processo de validação.

Aviso

Assim que uma imagem remota é carregada, CheckCertificateRevocationList é alterada para true durante o tempo de vida do aplicativo. Você pode reverter de volta para false manualmente, se necessário, mas assim que outra imagem remota é carregada, CheckCertificateRevocationList é definida truecomo .

Um recurso remoto que estava funcionando anteriormente pode falhar ao carregar quando a CRL armazenada em cache localmente estiver desatualizada e uma atualização não puder ser recuperada. Isso pode acontecer quando a rede em que o aplicativo está sendo executado é restrita e o local da CRL não está na lista de permitidos.

Também é possível que o atraso na verificação da CRL afete negativamente a capacidade do aplicativo de funcionar.

Você pode recusar esse comportamento definindo a opção System.Windows.Forms.ServicePointManagerCheckCrl para o aplicativo de uma das seguintes maneiras:

• Defina a propriedade como false no arquivo de configuração [app].runtimeconfig.json :

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

• Adicione um <RuntimeHostConfigurationOption> item no arquivo de projeto para desabilitá-lo:

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

Confira também

• LoadAsync

Load(String)

Origem:

PictureBox.cs

Define o ImageLocation para a URL especificada e exibe a imagem indicada.

public:
 void Load(System::String ^ url);

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Parâmetros

url

String

O caminho para a imagem a exibir no PictureBox.

Exceções

InvalidOperationException

url é null ou é uma cadeia de caracteres vazia.

WebException

url refere-se a uma imagem na Web que não pode ser acessada.

ArgumentException

url refere-se a um arquivo que não é uma imagem.

FileNotFoundException

url refere-se a um arquivo que não existe.

Comentários

Se o url parâmetro indicar um arquivo local, o formato recomendado será um caminho de arquivo local. Por exemplo, um arquivo de imagem chamado myPicture.jpg localizado em c:\ seria acessado passando c:\myPicture.jpg para o url parâmetro . Um caminho completo, como http://www.contoso.com/path/images/image.jpg, ou um caminho relativo, como ./images/image.jpg, pode ser usado. Se um caminho relativo for usado, ele será considerado em relação ao diretório de trabalho. Uma chamada para o Load método define a ImageLocation propriedade como o valor do url parâmetro .

Alterações de comportamento de carga

A partir do .NET 8, o comportamento de como um PictureBox controle carrega uma imagem remota foi alterado. Por padrão, a System.Net.ServicePointManager.CheckCertificateRevocationList propriedade é definida como true antes de uma imagem remota ser baixada por meio de WebClient. Essa configuração garante que os servidores com certificados tenham esses certificados verificados na CRL (lista de revogação de autoridade de certificação) como parte do processo de validação.

Aviso

Assim que uma imagem remota é carregada, CheckCertificateRevocationList é alterada para true durante o tempo de vida do aplicativo. Você pode reverter de volta para false manualmente, se necessário, mas assim que outra imagem remota é carregada, CheckCertificateRevocationList é definida truecomo .

Um recurso remoto que estava funcionando anteriormente pode falhar ao carregar quando a CRL armazenada em cache localmente estiver desatualizada e uma atualização não puder ser recuperada. Isso pode acontecer quando a rede em que o aplicativo está sendo executado é restrita e o local da CRL não está na lista de permitidos.

Também é possível que o atraso na verificação da CRL afete negativamente a capacidade do aplicativo de funcionar.

Você pode recusar esse comportamento definindo a opção System.Windows.Forms.ServicePointManagerCheckCrl para o aplicativo de uma das seguintes maneiras:

• Defina a propriedade como false no arquivo de configuração [app].runtimeconfig.json :

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

• Adicione um <RuntimeHostConfigurationOption> item no arquivo de projeto para desabilitá-lo:

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

Confira também

• ImageLocation