PictureBox.Load Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wyświetla obraz w obiekcie PictureBox.

Przeciążenia

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

Load()

Źródło:

PictureBox.cs

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 lub pusty ciąg.

Uwagi

Począwszy od platformy .NET 8, zachowanie sposobu, w jaki PictureBox kontrolka ładuje obraz zdalny uległ zmianie. Domyślnie właściwość jest ustawiona System.Net.ServicePointManager.CheckCertificateRevocationList 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 nie zostać załadowany, 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)

Źródło:

PictureBox.cs

ImageLocation Ustawia wartość na 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 lub pusty ciąg.

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 do pliku obrazu o nazwie myPicture.jpg znajdującego się w lokalizacji c:\ można uzyskać dostęp, przekazując c:\myPicture.jpg parametr 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 jest używana ś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 obraz zdalny uległ zmianie. Domyślnie właściwość jest ustawiona System.Net.ServicePointManager.CheckCertificateRevocationList 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 nie zostać załadowany, 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