PictureBox.Load Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

içinde PictureBoxbir görüntü görüntüler.

Aşırı Yüklemeler

Name	Description
Load()	özelliği PictureBoxtarafından ImageLocation belirtilen görüntüyü görüntüler.
Load(String)	öğesini ImageLocation belirtilen URL'ye ayarlar ve belirtilen görüntüyü görüntüler.

Load()

Kaynak:

PictureBox.cs

özelliği PictureBoxtarafından ImageLocation belirtilen görüntüyü görüntüler.

public:
 void Load();

public void Load();

member this.Load : unit -> unit

Public Sub Load ()

Özel durumlar

InvalidOperationException

ImageLocation veya null boş bir dizedir.

Açıklamalar

.NET 8'den başlayarak, bir PictureBox denetimin uzak görüntüyü yükleme davranışı değişti. Varsayılan olarak, System.Net.ServicePointManager.CheckCertificateRevocationList özelliği aracılığıyla uzak bir görüntü indirilmeden WebClientönce olarak ayarlanırtrue. Bu ayar, sertifikalara sahip sunucuların doğrulama işleminin bir parçası olarak bu sertifikaları sertifika yetkilisi iptal listesine (CRL) göre denetlemesini sağlar.

Uyarı

Uzak görüntü yüklenir yüklenmez, CheckCertificateRevocationList uygulamanın ömrü boyunca olarak değiştirilir true . Gerekirse el ile geri dönebilirsiniz false , ancak başka bir uzak görüntü yüklenir yüklenmez olarak CheckCertificateRevocationList ayarlanır true.

Yerel olarak önbelleğe alınmış CRL güncel olmadığında ve bir güncelleştirme alınamayınca daha önce çalışan bir uzak kaynak yüklenemeyebilir. Uygulamanın üzerinde çalıştığı ağ kısıtlandığında ve CRL konumu izin verilenler listesinde olmadığında bu durum oluşabilir.

CRL'nin denetlenmesindeki gecikmenin uygulamanın çalışma becerisini olumsuz etkilemesi de mümkündür.

Uygulamanın seçeneğini aşağıdaki yollardan biriyle ayarlayarak System.Windows.Forms.ServicePointManagerCheckCrl bu davranışı geri çevirebilirsiniz:

• [app].runtimeconfig.json yapılandırma dosyasında özelliğini false olarak ayarlayın:

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

• Devre dışı bırakmak için proje dosyasına bir <RuntimeHostConfigurationOption> öğe ekleyin:

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

Ayrıca bkz.

• LoadAsync

Load(String)

Kaynak:

PictureBox.cs

öğesini ImageLocation belirtilen URL'ye ayarlar ve belirtilen görüntüyü görüntüler.

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

public void Load(string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Parametreler

url

String

görüntünün içinde PictureBoxgörüntüleneceği yol.

Özel durumlar

InvalidOperationException

url veya null boş bir dizedir.

WebException

url Web'de erişilemeyen bir görüntüyü ifade eder.

ArgumentException

url görüntü olmayan bir dosyaya başvurur.

FileNotFoundException

url var olmayan bir dosyaya başvurur.

Açıklamalar

url Parametresi yerel bir dosya gösteriyorsa, önerilen biçim yerel bir dosya yoludur. Örneğin, c:\ konumunda bulunan myPicture.jpg adlı bir görüntü dosyasına parametresi geçirilerek c:\myPicture.jpgurl erişilebilir. gibi http://www.contoso.com/path/images/image.jpgtam bir yol veya ./images/image.jpggibi göreli bir yol kullanılabilir. Göreli bir yol kullanılırsa, çalışma dizinine göre değerlendirilir. yöntemine yapılan Load bir çağrı, özelliğini parametresinin url değerine ayarlarImageLocation.

Yük davranışı değişiklikleri

.NET 8'den başlayarak, bir PictureBox denetimin uzak görüntüyü yükleme davranışı değişti. Varsayılan olarak, System.Net.ServicePointManager.CheckCertificateRevocationList özelliği aracılığıyla uzak bir görüntü indirilmeden WebClientönce olarak ayarlanırtrue. Bu ayar, sertifikalara sahip sunucuların doğrulama işleminin bir parçası olarak bu sertifikaları sertifika yetkilisi iptal listesine (CRL) göre denetlemesini sağlar.

Uyarı

Uzak görüntü yüklenir yüklenmez, CheckCertificateRevocationList uygulamanın ömrü boyunca olarak değiştirilir true . Gerekirse el ile geri dönebilirsiniz false , ancak başka bir uzak görüntü yüklenir yüklenmez olarak CheckCertificateRevocationList ayarlanır true.

Yerel olarak önbelleğe alınmış CRL güncel olmadığında ve bir güncelleştirme alınamayınca daha önce çalışan bir uzak kaynak yüklenemeyebilir. Uygulamanın üzerinde çalıştığı ağ kısıtlandığında ve CRL konumu izin verilenler listesinde olmadığında bu durum oluşabilir.

CRL'nin denetlenmesindeki gecikmenin uygulamanın çalışma becerisini olumsuz etkilemesi de mümkündür.

Uygulamanın seçeneğini aşağıdaki yollardan biriyle ayarlayarak System.Windows.Forms.ServicePointManagerCheckCrl bu davranışı geri çevirebilirsiniz:

• [app].runtimeconfig.json yapılandırma dosyasında özelliğini false olarak ayarlayın:

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

• Devre dışı bırakmak için proje dosyasına bir <RuntimeHostConfigurationOption> öğe ekleyin:

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

Ayrıca bkz.

• ImageLocation