PictureBox.Load Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Visar en bild i PictureBox.

Överlagringar

Name Description
Load()

Visar den bild som anges av ImageLocation egenskapen för PictureBox.
Load(String)

ImageLocation Anger till den angivna URL:en och visar den angivna bilden.

Load()

Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs

Visar den bild som anges av ImageLocation egenskapen för PictureBox.

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

Undantag

InvalidOperationException

ImageLocation är null eller en tom sträng.

Kommentarer

Från och med .NET 8 ändras beteendet för hur en PictureBox-kontroll läser in en fjärrbild. Som standard är egenskapen System.Net.ServicePointManager.CheckCertificateRevocationList inställd på true innan en fjärrbild laddas ned via WebClient. Den här inställningen säkerställer att servrar med certifikat har dessa certifikat kontrollerade mot listan över återkallade certifikatutfärdare (CRL) som en del av valideringsprocessen.

Varning

Så snart en fjärrbild har lästs CheckCertificateRevocationList in ändras den till true för appens livslängd. Du kan återgå till false manuellt om det behövs, men så snart en annan fjärrbild har lästs CheckCertificateRevocationList in är inställd på true.

En tidigare fungerande fjärrresurs kan misslyckas med att läsa in när den lokalt cachelagrade crl-filen är inaktuell och en uppdatering inte kan hämtas. Detta kan inträffa när nätverket som appen körs på är begränsat och CRL-platsen inte finns på listan över tillåtna.

Det är också möjligt att fördröjningen i kontrollen av CRL påverkar appens funktionsmöjlighet negativt.

Du kan välja bort det här beteendet genom att ange alternativet System.Windows.Forms.ServicePointManagerCheckCrl för appen på något av följande sätt:

  • Ange egenskapen till false i konfigurationsfilen [app].runtimeconfig.json :

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

  • Lägg till ett <RuntimeHostConfigurationOption> objekt i projektfilen för att inaktivera det:

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

Se även

Gäller för

Load(String)

Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs
Källa:
PictureBox.cs

ImageLocation Anger till den angivna URL:en och visar den angivna bilden.

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

Parametrar

url
String

Sökvägen för bilden som ska visas i PictureBox.

Undantag

InvalidOperationException

url är null eller en tom sträng.

WebException

url refererar till en bild på webben som inte kan nås.

ArgumentException

url refererar till en fil som inte är en bild.

FileNotFoundException

url refererar till en fil som inte finns.

Kommentarer

Om parametern url anger en lokal fil är det rekommenderade formatet en lokal filsökväg. Till exempel skulle en bildfil med namnet myPicture.jpg som finns på c:\ nås genom att skicka c:\myPicture.jpg för parametern url . En fullständig sökväg, till exempel http://www.contoso.com/path/images/image.jpg, eller en relativ sökväg, till exempel ./images/image.jpg, kan användas. Om en relativ sökväg används betraktas den i förhållande till arbetskatalogen. Ett anrop till Load metoden anger ImageLocation egenskapen till värdet för parametern url .

Ändringar i inläsningsbeteende

Från och med .NET 8 ändras beteendet för hur en PictureBox-kontroll läser in en fjärrbild. Som standard är egenskapen System.Net.ServicePointManager.CheckCertificateRevocationList inställd på true innan en fjärrbild laddas ned via WebClient. Den här inställningen säkerställer att servrar med certifikat har dessa certifikat kontrollerade mot listan över återkallade certifikatutfärdare (CRL) som en del av valideringsprocessen.

Varning

Så snart en fjärrbild har lästs CheckCertificateRevocationList in ändras den till true för appens livslängd. Du kan återgå till false manuellt om det behövs, men så snart en annan fjärrbild har lästs CheckCertificateRevocationList in är inställd på true.

En tidigare fungerande fjärrresurs kan misslyckas med att läsa in när den lokalt cachelagrade crl-filen är inaktuell och en uppdatering inte kan hämtas. Detta kan inträffa när nätverket som appen körs på är begränsat och CRL-platsen inte finns på listan över tillåtna.

Det är också möjligt att fördröjningen i kontrollen av CRL påverkar appens funktionsmöjlighet negativt.

Du kan välja bort det här beteendet genom att ange alternativet System.Windows.Forms.ServicePointManagerCheckCrl för appen på något av följande sätt:

  • Ange egenskapen till false i konfigurationsfilen [app].runtimeconfig.json :

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

  • Lägg till ett <RuntimeHostConfigurationOption> objekt i projektfilen för att inaktivera det:

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

Se även

Gäller för