PictureBox.Load Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Apresenta uma imagem no PictureBoxarquivo .

Sobrecargas

Name Description
Load()

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

Define a ImageLocation URL especificada e mostra a imagem indicada.

Load()

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

Apresenta 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 é null ou uma corda vazia.

Observações

A partir do .NET 8, o comportamento de como um controlo PictureBox carrega uma imagem remota mudou. Por defeito, a System.Net.ServicePointManager.CheckCertificateRevocationList propriedade é definida para true antes de uma imagem remota ser descarregada através WebClientde . Esta configuração garante que os servidores com certificados têm esses certificados verificados em relação à lista de revogação da autoridade certificadora (CRL) como parte do processo de validação.

Warning

Assim que uma imagem remota é carregada, CheckCertificateRevocationList é alterada para true durante a vida útil da aplicação. Pode voltar ao false manual se necessário, mas assim que outra imagem remota for carregada, CheckCertificateRevocationList está definida para true.

Um recurso remoto a funcionar anteriormente pode falhar ao carregar quando o CRL em cache local está desatualizado e uma atualização não pode ser recuperada. Isto pode acontecer quando a rede onde a aplicação está a correr está restrita e a localização CRL não está na lista de permissões.

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

Pode optar por não participar neste comportamento definindo a opção System.Windows.Forms.ServicePointManagerCheckCrl para a aplicação, de uma das seguintes formas:

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

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

  • Adicione um <RuntimeHostConfigurationOption> item no ficheiro do projeto para o desativar:

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

Ver 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 mostra 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 ser exibida no PictureBox.

Exceções

InvalidOperationException

url é null ou uma corda vazia.

WebException

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

ArgumentException

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

FileNotFoundException

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

Observações

Se o url parâmetro indicar um ficheiro local, o formato recomendado é um caminho de ficheiro local. Por exemplo, um ficheiro de imagem chamado myPicture.jpg localizado em c:\ seria acedido passando c:\myPicture.jpg pelo 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 utilizado. Se for usado um caminho relativo, será considerado relativo ao diretório de trabalho. Uma chamada ao Load método define a ImageLocation propriedade para o valor do url parâmetro.

Alterações no comportamento da carga

A partir do .NET 8, o comportamento de como um controlo PictureBox carrega uma imagem remota mudou. Por defeito, a System.Net.ServicePointManager.CheckCertificateRevocationList propriedade é definida para true antes de uma imagem remota ser descarregada através WebClientde . Esta configuração garante que os servidores com certificados têm esses certificados verificados em relação à lista de revogação da autoridade certificadora (CRL) como parte do processo de validação.

Warning

Assim que uma imagem remota é carregada, CheckCertificateRevocationList é alterada para true durante a vida útil da aplicação. Pode voltar ao false manual se necessário, mas assim que outra imagem remota for carregada, CheckCertificateRevocationList está definida para true.

Um recurso remoto a funcionar anteriormente pode falhar ao carregar quando o CRL em cache local está desatualizado e uma atualização não pode ser recuperada. Isto pode acontecer quando a rede onde a aplicação está a correr está restrita e a localização CRL não está na lista de permissões.

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

Pode optar por não participar neste comportamento definindo a opção System.Windows.Forms.ServicePointManagerCheckCrl para a aplicação, de uma das seguintes formas:

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

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

  • Adicione um <RuntimeHostConfigurationOption> item no ficheiro do projeto para o desativar:

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

Ver também

Aplica-se a