PictureBox.Load Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zobrazí obrázek v objektu PictureBox.

Přetížení

Load()	Zobrazí obrázek určený ImageLocation vlastností objektu PictureBox.
Load(String)	ImageLocation Nastaví na zadanou adresu URL a zobrazí označený obrázek.

Load()

Zobrazí obrázek určený ImageLocation vlastností objektu PictureBox.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Výjimky

InvalidOperationException

ImageLocation je null nebo prázdný řetězec.

Poznámky

Od verze .NET 8 se změnilo chování, jakým PictureBox ovládací prvek načítá vzdálenou image. Ve výchozím nastavení je vlastnost nastavena System.Net.ServicePointManager.CheckCertificateRevocationList na true před stažením vzdálené image prostřednictvím WebClient. Toto nastavení zajistí, že servery s certifikáty budou mít tyto certifikáty v rámci procesu ověření zkontrolovány v seznamu odvolaných certifikátů (CRL).

Upozornění

Jakmile se načte vzdálená image, CheckCertificateRevocationList změní se na true po celou dobu životnosti aplikace. V případě potřeby se můžete vrátit zpět na false ručně, ale jakmile se načte jiná vzdálená image, CheckCertificateRevocationList nastaví se na truehodnotu .

Dříve fungující vzdálený prostředek se nemusí načíst, pokud je seznam CRL uložený v místní mezipaměti zastaralý a aktualizaci nejde načíst. K tomu může dojít v případě, že síť, ve které je aplikace spuštěná, je omezená a umístění seznamu CRL není na seznamu povolených.

Je také možné, že zpoždění při kontrole seznamu CRL negativně ovlivní schopnost aplikace fungovat.

Toto chování můžete odhlásit nastavením System.Windows.Forms.ServicePointManagerCheckCrl možnosti aplikace jedním z následujících způsobů:

• V konfiguračním souboru [app] nastavte vlastnost na false hodnotu .runtimeconfig.json:

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

• Přidejte položku <RuntimeHostConfigurationOption> do souboru projektu, abyste ji zakázali:

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

Viz také

• LoadAsync

Load(String)

ImageLocation Nastaví na zadanou adresu URL a zobrazí označený obrázek.

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

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Parametry

url

String

Cesta obrázku, která se má zobrazit v PictureBox.

Výjimky

InvalidOperationException

url je null nebo prázdný řetězec.

WebException

url odkazuje na obrázek na webu, ke kterému nelze získat přístup.

ArgumentException

url odkazuje na soubor, který není obrázkem.

FileNotFoundException

url odkazuje na soubor, který neexistuje.

Poznámky

url Pokud parametr označuje místní soubor, doporučeným formátem je cesta k místnímu souboru. Například soubor obrázku s názvem myPicture.jpg umístěný v umístění c:\ by byl přístupný předáním c:\myPicture.jpg parametru url . Můžete použít úplnou cestu, například http://www.contoso.com/path/images/image.jpg, nebo relativní cestu, například ./images/image.jpg. Pokud se použije relativní cesta, bude považována za relativní vzhledem k pracovnímu adresáři. Volání Load metody nastaví ImageLocation vlastnost na hodnotu parametru url .

Změny chování při načítání

Od verze .NET 8 se změnilo chování, jakým PictureBox ovládací prvek načítá vzdálenou image. Ve výchozím nastavení je vlastnost nastavena System.Net.ServicePointManager.CheckCertificateRevocationList na true před stažením vzdálené image prostřednictvím WebClient. Toto nastavení zajistí, že servery s certifikáty budou mít tyto certifikáty v rámci procesu ověření zkontrolovány v seznamu odvolaných certifikátů (CRL).

Upozornění

Jakmile se načte vzdálená image, CheckCertificateRevocationList změní se na true po celou dobu životnosti aplikace. V případě potřeby se můžete vrátit zpět na false ručně, ale jakmile se načte jiná vzdálená image, CheckCertificateRevocationList nastaví se na truehodnotu .

Dříve fungující vzdálený prostředek se nemusí načíst, pokud je seznam CRL uložený v místní mezipaměti zastaralý a aktualizaci nejde načíst. K tomu může dojít v případě, že síť, ve které je aplikace spuštěná, je omezená a umístění seznamu CRL není na seznamu povolených.

Je také možné, že zpoždění při kontrole seznamu CRL negativně ovlivní schopnost aplikace fungovat.

Toto chování můžete odhlásit nastavením System.Windows.Forms.ServicePointManagerCheckCrl možnosti aplikace jedním z následujících způsobů:

• V konfiguračním souboru [app] nastavte vlastnost na false hodnotu .runtimeconfig.json:

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

• Přidejte položku <RuntimeHostConfigurationOption> do souboru projektu, abyste ji zakázali:

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

Viz také

• ImageLocation