PictureBox.Load Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Visualizza un'immagine nel controllo PictureBox.

Overload

Load()

Visualizza l'immagine specificata dalla proprietà ImageLocation del controllo PictureBox.
Load(String)

Imposta la proprietà ImageLocation sull'URL specificato e visualizza l'immagine indicata.

Load()

Visualizza l'immagine specificata dalla proprietà ImageLocation del controllo PictureBox.

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

Eccezioni

InvalidOperationException

ImageLocation è null o una stringa vuota.

Commenti

A partire da .NET 8, il comportamento di modifica di un PictureBox controllo carica un'immagine remota. Per impostazione predefinita, la proprietà viene impostata su prima che System.Net.ServicePointManager.CheckCertificateRevocationList venga scaricata un'immagine remota tramite WebClient.true Questa impostazione garantisce che i server con certificati abbiano tali certificati controllati rispetto all'elenco di revoche dell'autorità di certificazione (CRL) come parte del processo di convalida.

Avviso

Non appena viene caricata un'immagine remota, CheckCertificateRevocationList viene modificata in true per la durata dell'app. È possibile ripristinare false manualmente se necessario, ma non appena viene caricata un'altra immagine remota, CheckCertificateRevocationList è impostata su true.

Una risorsa remota funzionante in precedenza potrebbe non riuscire a essere caricata quando il CRL memorizzato nella cache locale non è aggiornato e non è possibile recuperare un aggiornamento. Ciò può verificarsi quando la rete in cui è in esecuzione l'app è limitata e il percorso CRL non si trova nell'elenco elementi consentiti.

È anche possibile che il ritardo nel controllo dell'elenco CRL influisca negativamente sulla capacità dell'app di funzionare.

Puoi rifiutare esplicitamente questo comportamento impostando l'opzione System.Windows.Forms.ServicePointManagerCheckCrl per l'app, in uno dei modi seguenti:

  • Impostare la proprietà su false nel file di configurazione [app].runtimeconfig.json :

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

  • Aggiungere un <RuntimeHostConfigurationOption> elemento nel file di progetto per disabilitarlo:

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

Vedi anche

Si applica a

Load(String)

Imposta la proprietà ImageLocation sull'URL specificato e visualizza l'immagine indicata.

public:
 void Load(System::String ^ url);
public void Load (string url);
member this.Load : string -> unit
Public Sub Load (url As String)

Parametri

url
String

Percorso dell'immagine da visualizzare nel controllo PictureBox.

Eccezioni

InvalidOperationException

url è null o una stringa vuota.

WebException

url si riferisce ad un'immagine sul Web alla quale non è possibile accedere.

ArgumentException

url si riferisce ad un file non di immagine.

FileNotFoundException

url fa riferimento a un file inesistente.

Commenti

Se il url parametro indica un file locale, il formato consigliato è un percorso di file locale. Ad esempio, è possibile accedere a un file di immagine denominato myPicture.jpg che si trova in c:\ passando c:\myPicture.jpg per il url parametro . È possibile usare un percorso completo, ad esempio http://www.contoso.com/path/images/image.jpg, o un percorso relativo, ad esempio ./images/image.jpg. Se viene usato un percorso relativo, verrà considerato relativo alla directory di lavoro. Una chiamata al Load metodo imposta la ImageLocation proprietà sul valore del url parametro .

Modifiche al comportamento di caricamento

A partire da .NET 8, il comportamento di modifica di un PictureBox controllo carica un'immagine remota. Per impostazione predefinita, la proprietà viene impostata su prima che System.Net.ServicePointManager.CheckCertificateRevocationList venga scaricata un'immagine remota tramite WebClient.true Questa impostazione garantisce che i server con certificati abbiano tali certificati controllati rispetto all'elenco di revoche dell'autorità di certificazione (CRL) come parte del processo di convalida.

Avviso

Non appena viene caricata un'immagine remota, CheckCertificateRevocationList viene modificata in true per la durata dell'app. È possibile ripristinare false manualmente se necessario, ma non appena viene caricata un'altra immagine remota, CheckCertificateRevocationList è impostata su true.

Una risorsa remota funzionante in precedenza potrebbe non riuscire a essere caricata quando il CRL memorizzato nella cache locale non è aggiornato e non è possibile recuperare un aggiornamento. Ciò può verificarsi quando la rete in cui è in esecuzione l'app è limitata e il percorso CRL non si trova nell'elenco elementi consentiti.

È anche possibile che il ritardo nel controllo dell'elenco CRL influisca negativamente sulla capacità dell'app di funzionare.

Puoi rifiutare esplicitamente questo comportamento impostando l'opzione System.Windows.Forms.ServicePointManagerCheckCrl per l'app, in uno dei modi seguenti:

  • Impostare la proprietà su false nel file di configurazione [app].runtimeconfig.json :

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

  • Aggiungere un <RuntimeHostConfigurationOption> elemento nel file di progetto per disabilitarlo:

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

Vedi anche

Si applica a