PictureBox.Load Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Kép megjelenítése a . PictureBoxfájlban

Túlterhelések

Név	Description
Load()	A /> tulajdonsága által megadott kép megjelenítése.
Load(String)	Beállítja a ImageLocation megadott URL-címet, és megjeleníti a megjelenített képet.

Load()

Forrás:

PictureBox.cs

A /> tulajdonsága által megadott kép megjelenítése.

public:
 void Load();

public void Load();

member this.Load : unit -> unit

Public Sub Load ()

Kivételek

InvalidOperationException

ImageLocation vagy null üres sztring.

Megjegyzések

A .NET 8-tól kezdve a PictureBox vezérlő által a távoli rendszerképek betöltésének viselkedése módosult. Alapértelmezés szerint a System.Net.ServicePointManager.CheckCertificateRevocationList tulajdonság be van állítva, true mielőtt a távoli rendszerképet letöltené a WebClientrendszer. Ez a beállítás biztosítja, hogy a tanúsítványokkal rendelkező kiszolgálók az érvényesítési folyamat részeként ellenőrizve legyen a tanúsítványokat a hitelesítésszolgáltató visszavonási listáján (CRL).

Warning

A távoli rendszerkép betöltése CheckCertificateRevocationList után a rendszer az alkalmazás teljes élettartamára módosítja true a rendszerképet. Szükség esetén manuálisan is visszaállíthatja a false visszaállítást, de amint egy másik távoli rendszerkép be van töltve, CheckCertificateRevocationList a rendszer be van állítva true.

Előfordulhat, hogy egy korábban működő távoli erőforrás betöltése sikertelen lesz, ha a helyileg gyorsítótárazott CRL elavult, és a frissítés nem kérhető le. Ez akkor fordulhat elő, ha az alkalmazás által futtatott hálózat korlátozott, és a CRL helye nem szerepel az engedélyezési listán.

Az is lehetséges, hogy a CRL ellenőrzésének késleltetése negatívan befolyásolja az alkalmazás működését.

Ezt a viselkedést az alkalmazás System.Windows.Forms.ServicePointManagerCheckCrl beállításának beállításával tilthatja le az alábbi módok egyikével:

• Állítsa be a tulajdonságot false az [alkalmazás].runtimeconfig.json konfigurációs fájlba:

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

• Adjon hozzá egy <RuntimeHostConfigurationOption> elemet a projektfájlhoz a letiltásához:

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

Lásd még

• LoadAsync

Load(String)

Forrás:

PictureBox.cs

Beállítja a ImageLocation megadott URL-címet, és megjeleníti a megjelenített képet.

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

public void Load(string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Paraméterek

url

String

A kép PictureBoxelérési útja a .

Kivételek

InvalidOperationException

url vagy null üres sztring.

WebException

url olyan képre hivatkozik a weben, amely nem érhető el.

ArgumentException

url olyan fájlra hivatkozik, amely nem kép.

FileNotFoundException

url nem létező fájlra hivatkozik.

Megjegyzések

Ha a url paraméter helyi fájlt jelez, az ajánlott formátum egy helyi fájl elérési útja. Egy myPicture.jpg nevű képfájl például a c:\ helyen található, a c:\myPicture.jpg paraméter átadásával url érhető el. Egy teljes elérési út, például http://www.contoso.com/path/images/image.jpgegy relatív elérési út, például ./images/image.jpghasználható. Ha relatív elérési utat használ, az a munkakönyvtárhoz viszonyítva lesz figyelembe véve. A metódus hívása Load a ImageLocation tulajdonságot a paraméter értékére állítja url .

A betöltési viselkedés változásai

A .NET 8-tól kezdve a PictureBox vezérlő által a távoli rendszerképek betöltésének viselkedése módosult. Alapértelmezés szerint a System.Net.ServicePointManager.CheckCertificateRevocationList tulajdonság be van állítva, true mielőtt a távoli rendszerképet letöltené a WebClientrendszer. Ez a beállítás biztosítja, hogy a tanúsítványokkal rendelkező kiszolgálók az érvényesítési folyamat részeként ellenőrizve legyen a tanúsítványokat a hitelesítésszolgáltató visszavonási listáján (CRL).

Warning

A távoli rendszerkép betöltése CheckCertificateRevocationList után a rendszer az alkalmazás teljes élettartamára módosítja true a rendszerképet. Szükség esetén manuálisan is visszaállíthatja a false visszaállítást, de amint egy másik távoli rendszerkép be van töltve, CheckCertificateRevocationList a rendszer be van állítva true.

Előfordulhat, hogy egy korábban működő távoli erőforrás betöltése sikertelen lesz, ha a helyileg gyorsítótárazott CRL elavult, és a frissítés nem kérhető le. Ez akkor fordulhat elő, ha az alkalmazás által futtatott hálózat korlátozott, és a CRL helye nem szerepel az engedélyezési listán.

Az is lehetséges, hogy a CRL ellenőrzésének késleltetése negatívan befolyásolja az alkalmazás működését.

Ezt a viselkedést az alkalmazás System.Windows.Forms.ServicePointManagerCheckCrl beállításának beállításával tilthatja le az alábbi módok egyikével:

• Állítsa be a tulajdonságot false az [alkalmazás].runtimeconfig.json konfigurációs fájlba:

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

• Adjon hozzá egy <RuntimeHostConfigurationOption> elemet a projektfájlhoz a letiltásához:

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

Lásd még

• ImageLocation