PictureBox.Load Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menampilkan gambar di PictureBox.

Overload

Load()	Menampilkan gambar yang ditentukan oleh ImageLocation properti dari PictureBox.
Load(String)	ImageLocation Mengatur ke URL yang ditentukan dan menampilkan gambar yang ditunjukkan.

Load()

Menampilkan gambar yang ditentukan oleh ImageLocation properti dari PictureBox.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Pengecualian

InvalidOperationException

ImageLocation adalah null atau string kosong.

Keterangan

Dimulai dengan .NET 8, perilaku bagaimana PictureBox kontrol memuat gambar jarak jauh berubah. Secara default, System.Net.ServicePointManager.CheckCertificateRevocationList properti diatur ke true sebelum gambar jarak jauh diunduh melalui WebClient. Pengaturan ini memastikan bahwa server dengan sertifikat memiliki sertifikat yang diperiksa terhadap daftar pencabutan otoritas sertifikat (CRL) sebagai bagian dari proses validasi.

Peringatan

Segera setelah gambar jarak jauh dimuat, CheckCertificateRevocationList diubah menjadi true untuk masa pakai aplikasi. Anda dapat kembali ke false secara manual jika diperlukan, tetapi segera setelah gambar jarak jauh lain dimuat, CheckCertificateRevocationList diatur ke true.

Sumber daya jarak jauh yang sebelumnya berfungsi mungkin gagal dimuat ketika CRL yang di-cache secara lokal sudah kedaluarsa dan pembaruan tidak dapat diambil. Ini dapat terjadi ketika jaringan tempat aplikasi berjalan dibatasi dan lokasi CRL tidak ada dalam daftar yang diizinkan.

Ada kemungkinan juga bahwa keterlambatan dalam memeriksa CRL secara negatif memengaruhi kemampuan aplikasi untuk berfungsi.

Anda dapat menolak perilaku ini dengan mengatur System.Windows.Forms.ServicePointManagerCheckCrl opsi untuk aplikasi, dengan salah satu cara berikut:

• Atur properti ke false dalam file konfigurasi [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Tambahkan item dalam file proyek untuk menonaktifkannya:

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

Lihat juga

• LoadAsync

Load(String)

ImageLocation Mengatur ke URL yang ditentukan dan menampilkan gambar yang ditunjukkan.

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

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Parameter

url

String

Jalur untuk gambar yang ditampilkan di PictureBox.

Pengecualian

InvalidOperationException

url adalah null atau string kosong.

WebException

url mengacu pada gambar di Web yang tidak dapat diakses.

ArgumentException

url mengacu pada file yang bukan gambar.

FileNotFoundException

url mengacu pada file yang tidak ada.

Keterangan

url Jika parameter menunjukkan file lokal, format yang disarankan adalah jalur file lokal. Misalnya, file gambar bernama myPicture.jpg yang terletak di c:\ akan diakses dengan meneruskan c:\myPicture.jpgurl parameter . Jalur lengkap, seperti http://www.contoso.com/path/images/image.jpg, atau jalur relatif, seperti ./images/image.jpg, dapat digunakan. Jika jalur relatif digunakan, jalur tersebut akan dianggap relatif terhadap direktori kerja. Panggilan ke Load metode mengatur ImageLocation properti ke nilai url parameter.

Perubahan perilaku beban

Dimulai dengan .NET 8, perilaku bagaimana PictureBox kontrol memuat gambar jarak jauh berubah. Secara default, System.Net.ServicePointManager.CheckCertificateRevocationList properti diatur ke true sebelum gambar jarak jauh diunduh melalui WebClient. Pengaturan ini memastikan bahwa server dengan sertifikat memiliki sertifikat yang diperiksa terhadap daftar pencabutan otoritas sertifikat (CRL) sebagai bagian dari proses validasi.

Peringatan

Segera setelah gambar jarak jauh dimuat, CheckCertificateRevocationList diubah menjadi true untuk masa pakai aplikasi. Anda dapat kembali ke false secara manual jika diperlukan, tetapi segera setelah gambar jarak jauh lain dimuat, CheckCertificateRevocationList diatur ke true.

Sumber daya jarak jauh yang sebelumnya berfungsi mungkin gagal dimuat ketika CRL yang di-cache secara lokal sudah kedaluarsa dan pembaruan tidak dapat diambil. Ini dapat terjadi ketika jaringan tempat aplikasi berjalan dibatasi dan lokasi CRL tidak ada dalam daftar yang diizinkan.

Ada kemungkinan juga bahwa keterlambatan dalam memeriksa CRL secara negatif memengaruhi kemampuan aplikasi untuk berfungsi.

Anda dapat menolak perilaku ini dengan mengatur System.Windows.Forms.ServicePointManagerCheckCrl opsi untuk aplikasi, dengan salah satu cara berikut:

• Atur properti ke false dalam file konfigurasi [app].runtimeconfig.json :

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

• <RuntimeHostConfigurationOption> Tambahkan item dalam file proyek untuk menonaktifkannya:

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

Lihat juga

• ImageLocation