PictureBox.Load Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Zeigt ein Bild in der PictureBox an.

Überlädt

Load()

Zeigt das von der ImageLocation-Eigenschaft der PictureBox angegebene Bild an.
Load(String)

Legt die ImageLocation auf die angegebene URL fest und zeigt das angegebene Bild an.

Load()

Zeigt das von der ImageLocation-Eigenschaft der PictureBox angegebene Bild an.

public:
 void Load();
public void Load ();
member this.Load : unit -> unit
Public Sub Load ()

Ausnahmen

InvalidOperationException

Der ImageLocation ist null oder eine leere Zeichenfolge.

Hinweise

Ab .NET 8 hat sich das Verhalten, wie ein PictureBox Steuerelement ein Remoteimage lädt, geändert. Standardmäßig ist die System.Net.ServicePointManager.CheckCertificateRevocationList -Eigenschaft auf true festgelegt, bevor ein Remoteimage über WebClientheruntergeladen wird. Diese Einstellung stellt sicher, dass bei Servern mit Zertifikaten diese Zertifikate im Rahmen des Überprüfungsprozesses mit der Sperrliste der Zertifizierungsstelle (Certificate Authority Revocation List, CRL) überprüft werden.

Warnung

Sobald ein Remoteimage geladen wird, CheckCertificateRevocationList wird für die Lebensdauer der App in true geändert. Sie können bei Bedarf manuell zu false rückgängig machen, aber sobald ein anderes Remoteimage geladen wird, CheckCertificateRevocationList wird auf truefestgelegt.

Eine zuvor funktionierende Remoteressource kann möglicherweise nicht geladen werden, wenn die lokal zwischengespeicherte Zertifikatsperrliste veraltet ist und ein Update nicht abgerufen werden kann. Dies kann passieren, wenn das Netzwerk, in dem die App ausgeführt wird, eingeschränkt ist und sich der Speicherort der Sperrliste nicht auf der Zulassungsliste befindet.

Es ist auch möglich, dass sich die Verzögerung bei der Überprüfung der Zertifikatsperrliste negativ auf die Funktionsfähigkeit der App auswirkt.

Sie können dieses Verhalten deaktivieren, indem Sie die System.Windows.Forms.ServicePointManagerCheckCrl Option für die App auf eine der folgenden Arten festlegen:

  • Legen Sie die -Eigenschaft false in der Konfigurationsdatei [app].runtimeconfig.json fest:

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

  • Fügen Sie ein <RuntimeHostConfigurationOption> Element in der Projektdatei hinzu, um es zu deaktivieren:

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

Weitere Informationen

Gilt für:

Load(String)

Legt die ImageLocation auf die angegebene URL fest und zeigt das angegebene Bild an.

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

Der Pfad des Bildes, das in der PictureBox angezeigt werden soll.

Ausnahmen

InvalidOperationException

Der url ist null oder eine leere Zeichenfolge.

WebException

url verweist auf ein Bild im Web, auf das nicht zugegriffen werden kann.

ArgumentException

url verweist auf eine Datei, die kein Bild ist.

FileNotFoundException

url verweist auf eine Datei, die nicht vorhanden ist.

Hinweise

Wenn der url Parameter eine lokale Datei angibt, ist das empfohlene Format ein lokaler Dateipfad. Beispielsweise wird auf eine Bilddatei namens myPicture.jpg in c:\ zugegriffen, indem der url Parameter übergeben c:\myPicture.jpg wird. Ein vollständiger Pfad, z http://www.contoso.com/path/images/image.jpg. B. , oder ein relativer Pfad, z . B. ./images/image.jpg, kann verwendet werden. Wenn ein relativer Pfad verwendet wird, wird er relativ zum Arbeitsverzeichnis betrachtet. Ein Aufruf der Load -Methode legt die ImageLocation -Eigenschaft auf den Wert des url Parameters fest.

Änderungen des Lastverhaltens

Ab .NET 8 hat sich das Verhalten, wie ein PictureBox Steuerelement ein Remoteimage lädt, geändert. Standardmäßig ist die System.Net.ServicePointManager.CheckCertificateRevocationList -Eigenschaft auf true festgelegt, bevor ein Remoteimage über WebClientheruntergeladen wird. Diese Einstellung stellt sicher, dass bei Servern mit Zertifikaten diese Zertifikate im Rahmen des Überprüfungsprozesses mit der Sperrliste der Zertifizierungsstelle (Certificate Authority Revocation List, CRL) überprüft werden.

Warnung

Sobald ein Remoteimage geladen wird, CheckCertificateRevocationList wird für die Lebensdauer der App in true geändert. Sie können bei Bedarf manuell zu false rückgängig machen, aber sobald ein anderes Remoteimage geladen wird, CheckCertificateRevocationList wird auf truefestgelegt.

Eine zuvor funktionierende Remoteressource kann möglicherweise nicht geladen werden, wenn die lokal zwischengespeicherte Zertifikatsperrliste veraltet ist und ein Update nicht abgerufen werden kann. Dies kann passieren, wenn das Netzwerk, in dem die App ausgeführt wird, eingeschränkt ist und sich der Speicherort der Sperrliste nicht auf der Zulassungsliste befindet.

Es ist auch möglich, dass sich die Verzögerung bei der Überprüfung der Zertifikatsperrliste negativ auf die Funktionsfähigkeit der App auswirkt.

Sie können dieses Verhalten deaktivieren, indem Sie die System.Windows.Forms.ServicePointManagerCheckCrl Option für die App auf eine der folgenden Arten festlegen:

  • Legen Sie die -Eigenschaft false in der Konfigurationsdatei [app].runtimeconfig.json fest:

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

  • Fügen Sie ein <RuntimeHostConfigurationOption> Element in der Projektdatei hinzu, um es zu deaktivieren:

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

Weitere Informationen

Gilt für: