Compartilhar via

PictureBox.Load Método

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Exibe uma imagem no PictureBox.

Sobrecargas

Nome Description
Load()

Exibe a imagem especificada pela ImageLocation propriedade do PictureBox.
Load(String)

Define a ImageLocation URL especificada e exibe a imagem indicada.

Load()

Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs

Exibe a imagem especificada pela ImageLocation propriedade do PictureBox.

public:
 void Load();
public void Load();
member this.Load : unit -> unit
Public Sub Load ()

Exceções

InvalidOperationException

ImageLocation é ou uma null 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 WebClientde . 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 o tempo de vida do aplicativo. Você pode reverter para false manualmente, se necessário, mas assim que outra imagem remota é carregada, CheckCertificateRevocationList é definida como true.

Um recurso remoto em funcionamento 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 na qual o aplicativo está sendo executado é restrita e o local da CRL não está na lista de permissões.

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 .runtimeconfig.json[aplicativo ]:

    {
  "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

Aplica-se a

Load(String)

Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs
Origem:
PictureBox.cs

Define a ImageLocation 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 ser exibida no PictureBox.

Exceções

InvalidOperationException

url é ou uma null 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 WebClientde . 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 o tempo de vida do aplicativo. Você pode reverter para false manualmente, se necessário, mas assim que outra imagem remota é carregada, CheckCertificateRevocationList é definida como true.

Um recurso remoto em funcionamento 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 na qual o aplicativo está sendo executado é restrita e o local da CRL não está na lista de permissões.

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 .runtimeconfig.json[aplicativo ]:

    {
  "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

Aplica-se a