PictureBox.Load Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zobrazí obrázek v objektu PictureBox.

Přetížení

Name	Description
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()

Zdroj:

PictureBox.cs

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

Počínaje rozhraním .NET 8 se chování PictureBox ovládacího prvku načte ve vzdálené imagi. Ve výchozím nastavení System.Net.ServicePointManager.CheckCertificateRevocationList je vlastnost nastavena na true před stažením vzdáleného obrázku prostřednictvím WebClient. Toto nastavení zajistí, že servery s certifikáty budou mít tyto certifikáty v rámci procesu ověření kontrolovány v seznamu odvolaných certifikátů (CRL).

Výstraha

Jakmile se načte vzdálený obrázek, CheckCertificateRevocationList změní se na true dobu životnosti aplikace. Pokud je to potřeba, můžete se vrátit zpět false ručně, ale jakmile se načte jiný vzdálený obrázek, CheckCertificateRevocationList je nastaven na truehodnotu .

Dříve fungující vzdálený prostředek se nemusí načíst, pokud je seznam CRL místně uložený v mezipaměti zastaralý a aktualizace se nedá načíst. K tomu může dojít, když je síť, na které je aplikace spuštěná, omezena 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ě ovlivňuje schopnost aplikace fungovat.

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

• Nastavte vlastnost do falsekonfiguračního souboru [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Přidejte položku do souboru projektu a zakažte ji:

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

Viz také

• LoadAsync

Load(String)

Zdroj:

PictureBox.cs

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 k obrázku, která se má zobrazit v souboru 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ý formát je místní cesta k souboru. Například soubor obrázku s názvem myPicture.jpg umístěný v c:\ by byl přístupný předáním c:\myPicture.jpg parametru url . Lze použít úplnou cestu, například nebo relativní cestu, například http://www.contoso.com/path/images/image.jpg./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í

Počínaje rozhraním .NET 8 se chování PictureBox ovládacího prvku načte ve vzdálené imagi. Ve výchozím nastavení System.Net.ServicePointManager.CheckCertificateRevocationList je vlastnost nastavena na true před stažením vzdáleného obrázku prostřednictvím WebClient. Toto nastavení zajistí, že servery s certifikáty budou mít tyto certifikáty v rámci procesu ověření kontrolovány v seznamu odvolaných certifikátů (CRL).

Výstraha

Jakmile se načte vzdálený obrázek, CheckCertificateRevocationList změní se na true dobu životnosti aplikace. Pokud je to potřeba, můžete se vrátit zpět false ručně, ale jakmile se načte jiný vzdálený obrázek, CheckCertificateRevocationList je nastaven na truehodnotu .

Dříve fungující vzdálený prostředek se nemusí načíst, pokud je seznam CRL místně uložený v mezipaměti zastaralý a aktualizace se nedá načíst. K tomu může dojít, když je síť, na které je aplikace spuštěná, omezena 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ě ovlivňuje schopnost aplikace fungovat.

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

• Nastavte vlastnost do falsekonfiguračního souboru [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Přidejte položku do souboru projektu a zakažte ji:

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

Viz také

• ImageLocation