PictureBox.Load Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Affiche une image dans le PictureBox.

Surcharges

Nom	Description
Load()	Affiche l’image spécifiée par la ImageLocation propriété du PictureBox.
Load(String)	Définit l’URL ImageLocation spécifiée et affiche l’image indiquée.

Load()

Source:

PictureBox.cs

Affiche l’image spécifiée par la ImageLocation propriété du PictureBox.

public:
 void Load();

public void Load();

member this.Load : unit -> unit

Public Sub Load ()

Exceptions

InvalidOperationException

ImageLocation est null ou une chaîne vide.

Remarques

À compter de .NET 8, le comportement d’un PictureBox contrôle charge une image distante modifiée. Par défaut, la System.Net.ServicePointManager.CheckCertificateRevocationList propriété est définie true avant le téléchargement d’une image distante via WebClient. Ce paramètre garantit que les serveurs avec certificats disposent de 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 elle est modifiée true pour la durée de vie de l’application. Vous pouvez revenir manuellement si false nécessaire, mais dès qu’une autre image distante est chargée, CheckCertificateRevocationList elle est définie sur true.

Une ressource distante précédemment opérationnelle peut ne pas être chargée lorsque la liste de révocation de certificats mis 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 n’est pas sur la liste verte.

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 désactiver ce comportement en définissant l’option System.Windows.Forms.ServicePointManagerCheckCrl de l’application de l’une des manières suivantes :

• Définissez la propriété false 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

Définit l’URL ImageLocation 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 le PictureBox.

Exceptions

InvalidOperationException

url est null ou une chaîne vide.

WebException

url fait référence à une image sur le web qui n’est pas accessible.

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 de fichier local. Par exemple, un fichier image nommé myPicture.jpg situé à 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 d’accès relatif est utilisé, il est considéré par rapport au répertoire de travail. Un appel à la Load méthode définit la ImageLocation propriété sur la valeur du url paramètre.

Modifications du comportement de chargement

À compter de .NET 8, le comportement d’un PictureBox contrôle charge une image distante modifiée. Par défaut, la System.Net.ServicePointManager.CheckCertificateRevocationList propriété est définie true avant le téléchargement d’une image distante via WebClient. Ce paramètre garantit que les serveurs avec certificats disposent de 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 elle est modifiée true pour la durée de vie de l’application. Vous pouvez revenir manuellement si false nécessaire, mais dès qu’une autre image distante est chargée, CheckCertificateRevocationList elle est définie sur true.

Une ressource distante précédemment opérationnelle peut ne pas être chargée lorsque la liste de révocation de certificats mis 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 n’est pas sur la liste verte.

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 désactiver ce comportement en définissant l’option System.Windows.Forms.ServicePointManagerCheckCrl de l’application de l’une des manières suivantes :

• Définissez la propriété false 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