PictureBox.Load Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Affiche une image dans PictureBox.

Surcharges

Load()	Affiche l'image spécifiée par la propriété ImageLocation de PictureBox.
Load(String)	Affecte à ImageLocation l'URL spécifiée et affiche l'image indiquée.

Load()

Source:

PictureBox.cs

Affiche l'image spécifiée par la propriété ImageLocation de PictureBox.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Exceptions

InvalidOperationException

ImageLocation est soit null soit une chaîne vide.

Remarques

À compter de .NET 8, le comportement du chargement d’une image distante par un PictureBox contrôle a changé. Par défaut, la System.Net.ServicePointManager.CheckCertificateRevocationList propriété est définie sur true avant le téléchargement d’une image distante via WebClient. Ce paramètre garantit que les serveurs avec des certificats ont ces certificats vérifiés par rapport à la liste de révocation des autorités de certification (CRL) dans le cadre du processus de validation.

Avertissement

Dès qu’une image distante est chargée, CheckCertificateRevocationList est remplacé par true pour la durée de vie de l’application. Vous pouvez revenir à false manuellement si nécessaire, mais dès qu’une autre image distante est chargée, CheckCertificateRevocationList est défini sur true.

Le chargement d’une ressource distante précédemment opérationnelle peut échouer lorsque la liste de révocation de certificats mise en cache localement est obsolète et qu’une mise à jour ne peut pas être récupérée. Cela peut se produire lorsque le réseau sur lequel l’application s’exécute est restreint et que l’emplacement de la liste de révocation de certificats ne figure pas dans la liste d’autorisation.

Il est également possible que le délai de vérification de la liste de révocation de certificats affecte négativement la capacité de l’application à fonctionner.

Vous pouvez refuser ce comportement en définissant l’option System.Windows.Forms.ServicePointManagerCheckCrl pour l’application, de l’une des manières suivantes :

• Définissez la propriété false sur dans le fichier de configuration [app].runtimeconfig.json :

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

• Ajoutez un <RuntimeHostConfigurationOption> élément dans le fichier projet pour le désactiver :

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

Voir aussi

• LoadAsync

Load(String)

Source:

PictureBox.cs

Affecte à ImageLocation l'URL spécifiée et affiche l'image indiquée.

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

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Paramètres

url

String

Chemin d'accès de l'image à afficher dans PictureBox.

Exceptions

InvalidOperationException

url est soit null soit une chaîne vide.

WebException

url fait référence à une image inaccessible sur le Web.

ArgumentException

url fait référence à un fichier qui n'est pas une image.

FileNotFoundException

url fait référence à un fichier qui n'existe pas.

Remarques

Si le url paramètre indique un fichier local, le format recommandé est un chemin d’accès au fichier local. Par exemple, un fichier image nommé myPicture.jpg situé à l’emplacement c :\ est accessible en passant c:\myPicture.jpg pour le url paramètre . Un chemin d’accès complet, tel que http://www.contoso.com/path/images/image.jpg, ou un chemin relatif, tel que ./images/image.jpg, peut être utilisé. Si un chemin relatif est utilisé, il est considéré comme relatif au répertoire de travail. Un appel à la Load méthode affecte à la ImageLocation propriété la valeur du url paramètre .

Changements de comportement de chargement

À compter de .NET 8, le comportement du chargement d’une image distante par un PictureBox contrôle a changé. Par défaut, la System.Net.ServicePointManager.CheckCertificateRevocationList propriété est définie sur true avant le téléchargement d’une image distante via WebClient. Ce paramètre garantit que les serveurs avec des certificats ont ces certificats vérifiés par rapport à la liste de révocation des autorités de certification (CRL) dans le cadre du processus de validation.

Avertissement

Dès qu’une image distante est chargée, CheckCertificateRevocationList est remplacé par true pour la durée de vie de l’application. Vous pouvez revenir à false manuellement si nécessaire, mais dès qu’une autre image distante est chargée, CheckCertificateRevocationList est défini sur true.

Le chargement d’une ressource distante précédemment opérationnelle peut échouer lorsque la liste de révocation de certificats mise en cache localement est obsolète et qu’une mise à jour ne peut pas être récupérée. Cela peut se produire lorsque le réseau sur lequel l’application s’exécute est restreint et que l’emplacement de la liste de révocation de certificats ne figure pas dans la liste d’autorisation.

Il est également possible que le délai de vérification de la liste de révocation de certificats affecte négativement la capacité de l’application à fonctionner.

Vous pouvez refuser ce comportement en définissant l’option System.Windows.Forms.ServicePointManagerCheckCrl pour l’application, de l’une des manières suivantes :

• Définissez la propriété false sur dans le fichier de configuration [app].runtimeconfig.json :

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

• Ajoutez un <RuntimeHostConfigurationOption> élément dans le fichier projet pour le désactiver :

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

Voir aussi

• ImageLocation