PictureBox.Load Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wyświetla obraz w obiekcie PictureBox.

Przeciążenia

Load()	Wyświetla obraz określony przez ImageLocation właściwość .PictureBox
Load(String)	ImageLocation Ustawia określony adres URL i wyświetla wskazany obraz.

Load()

Wyświetla obraz określony przez ImageLocation właściwość .PictureBox

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Wyjątki

InvalidOperationException

ImageLocation jest null ciągiem lub ciągiem pustym.

Uwagi

Począwszy od platformy .NET 8, zachowanie sposobu, w jaki PictureBox kontrolka ładuje zdalny obraz, uległ zmianie. Domyślnie System.Net.ServicePointManager.CheckCertificateRevocationList właściwość jest ustawiana na true wartość przed pobraniem obrazu zdalnego za pośrednictwem polecenia WebClient. To ustawienie zapewnia, że serwery z certyfikatami mają te certyfikaty sprawdzane względem listy odwołania urzędu certyfikacji (CRL) w ramach procesu weryfikacji.

Ostrzeżenie

Po załadowaniu CheckCertificateRevocationList obrazu zdalnego zostanie zmieniony na true okres istnienia aplikacji. Jeśli jest to wymagane, możesz przywrócić false ręcznie, ale po załadowaniu CheckCertificateRevocationList innego obrazu zdalnego jest ustawiona wartość true.

Wcześniej działający zasób zdalny może zakończyć się niepowodzeniem, gdy lokalnie buforowana lista CRL jest nieaktualna i nie można pobrać aktualizacji. Może się tak zdarzyć, gdy sieć, na którym działa aplikacja, jest ograniczona, a lokalizacja listy CRL nie znajduje się na liście dozwolonych.

Istnieje również możliwość, że opóźnienie sprawdzania listy CRL negatywnie wpływa na zdolność aplikacji do działania.

Możesz zrezygnować z tego zachowania, ustawiając System.Windows.Forms.ServicePointManagerCheckCrl opcję dla aplikacji na jeden z następujących sposobów:

• Ustaw właściwość na false w pliku konfiguracji [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Dodaj element w pliku projektu, aby go wyłączyć:

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

Zobacz też

• LoadAsync

Load(String)

ImageLocation Ustawia określony adres URL i wyświetla wskazany obraz.

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

Ścieżka obrazu do wyświetlenia w pliku PictureBox.

Wyjątki

InvalidOperationException

url jest null ciągiem lub ciągiem pustym.

WebException

url odwołuje się do obrazu w sieci Web, do którego nie można uzyskać dostępu.

ArgumentException

url odwołuje się do pliku, który nie jest obrazem.

FileNotFoundException

url odwołuje się do pliku, który nie istnieje.

Uwagi

url Jeśli parametr wskazuje plik lokalny, zalecanym formatem jest ścieżka pliku lokalnego. Na przykład plik obrazu o nazwie myPicture.jpg znajdujący się w lokalizacji c:\ będzie dostępny przez przekazanie c:\myPicture.jpg parametru url . Można użyć pełnej ścieżki, takiej jak http://www.contoso.com/path/images/image.jpg, lub ścieżki względnej, takiej jak ./images/image.jpg. Jeśli używana jest ścieżka względna, zostanie ona uznana za względną dla katalogu roboczego. Wywołanie Load metody ustawia ImageLocation właściwość na wartość parametru url .

Zmiany zachowania ładowania

Począwszy od platformy .NET 8, zachowanie sposobu, w jaki PictureBox kontrolka ładuje zdalny obraz, uległ zmianie. Domyślnie System.Net.ServicePointManager.CheckCertificateRevocationList właściwość jest ustawiana na true wartość przed pobraniem obrazu zdalnego za pośrednictwem polecenia WebClient. To ustawienie zapewnia, że serwery z certyfikatami mają te certyfikaty sprawdzane względem listy odwołania urzędu certyfikacji (CRL) w ramach procesu weryfikacji.

Ostrzeżenie

Po załadowaniu CheckCertificateRevocationList obrazu zdalnego zostanie zmieniony na true okres istnienia aplikacji. Jeśli jest to wymagane, możesz przywrócić false ręcznie, ale po załadowaniu CheckCertificateRevocationList innego obrazu zdalnego jest ustawiona wartość true.

Wcześniej działający zasób zdalny może zakończyć się niepowodzeniem, gdy lokalnie buforowana lista CRL jest nieaktualna i nie można pobrać aktualizacji. Może się tak zdarzyć, gdy sieć, na którym działa aplikacja, jest ograniczona, a lokalizacja listy CRL nie znajduje się na liście dozwolonych.

Istnieje również możliwość, że opóźnienie sprawdzania listy CRL negatywnie wpływa na zdolność aplikacji do działania.

Możesz zrezygnować z tego zachowania, ustawiając System.Windows.Forms.ServicePointManagerCheckCrl opcję dla aplikacji na jeden z następujących sposobów:

• Ustaw właściwość na false w pliku konfiguracji [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Dodaj element w pliku projektu, aby go wyłączyć:

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

Zobacz też

• ImageLocation