PictureBox.Load Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Zeigt ein Bild in der PictureBox.

Überlädt

Name	Beschreibung
Load()	Zeigt das bild an, das durch die ImageLocation Eigenschaft der .PictureBox
Load(String)	Legt die ImageLocation angegebene URL fest und zeigt das angegebene Bild an.

Load()

Quelle:

PictureBox.cs

Zeigt das bild an, das durch die ImageLocation Eigenschaft der .PictureBox

public:
 void Load();

public void Load();

member this.Load : unit -> unit

Public Sub Load ()

Ausnahmen

InvalidOperationException

ImageLocation ist null oder eine leere Zeichenfolge.

Hinweise

Ab .NET 8 ändert sich das Verhalten, wie ein PictureBox Steuerelement ein Remoteimage lädt. Standardmäßig wird die System.Net.ServicePointManager.CheckCertificateRevocationList Eigenschaft so true festgelegt, dass ein Remotebild über WebClientdie Datei heruntergeladen wird. Diese Einstellung stellt sicher, dass Server mit Zertifikaten diese Zertifikate im Rahmen des Überprüfungsprozesses auf die Sperrliste der Zertifizierungsstelle überprüft haben.

Warnung

Sobald ein Remoteimage geladen wird, CheckCertificateRevocationList wird für die Lebensdauer der App in true "Geändert". Sie können bei Bedarf wieder manuell false zurückkehren, aber sobald ein weiteres Remoteimage geladen wird, CheckCertificateRevocationList auf true.

Eine zuvor funktionierende Remoteressource kann nicht geladen werden, wenn die lokal zwischengespeicherte CRL veraltet ist und ein Update nicht abgerufen werden kann. Dies kann passieren, wenn das Netzwerk, auf dem die App ausgeführt wird, eingeschränkt ist und der CRL-Speicherort nicht in der Zulassungsliste enthalten ist.

Es ist auch möglich, dass sich die Verzögerung bei der Überprüfung der CRL 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 in der [app].runtimeconfig.json Konfigurationsdatei festfalse:

  {
    "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

• LoadAsync

Load(String)

Quelle:

PictureBox.cs

Legt die ImageLocation 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 für das Bild, das in der PictureBoxAbbildung angezeigt werden soll.

Ausnahmen

InvalidOperationException

url ist null oder eine leere Zeichenfolge.

WebException

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

ArgumentException

url bezieht sich 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. Auf eine Bilddatei mit dem Namen myPicture.jpg unter "c:\" wird beispielsweise durch Übergeben c:\myPicture.jpg des url Parameters zugegriffen. Ein vollständiger Pfad, z http://www.contoso.com/path/images/image.jpg. B. 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 Ladeverhaltens

Ab .NET 8 ändert sich das Verhalten, wie ein PictureBox Steuerelement ein Remoteimage lädt. Standardmäßig wird die System.Net.ServicePointManager.CheckCertificateRevocationList Eigenschaft so true festgelegt, dass ein Remotebild über WebClientdie Datei heruntergeladen wird. Diese Einstellung stellt sicher, dass Server mit Zertifikaten diese Zertifikate im Rahmen des Überprüfungsprozesses auf die Sperrliste der Zertifizierungsstelle überprüft haben.

Warnung

Sobald ein Remoteimage geladen wird, CheckCertificateRevocationList wird für die Lebensdauer der App in true "Geändert". Sie können bei Bedarf wieder manuell false zurückkehren, aber sobald ein weiteres Remoteimage geladen wird, CheckCertificateRevocationList auf true.

Eine zuvor funktionierende Remoteressource kann nicht geladen werden, wenn die lokal zwischengespeicherte CRL veraltet ist und ein Update nicht abgerufen werden kann. Dies kann passieren, wenn das Netzwerk, auf dem die App ausgeführt wird, eingeschränkt ist und der CRL-Speicherort nicht in der Zulassungsliste enthalten ist.

Es ist auch möglich, dass sich die Verzögerung bei der Überprüfung der CRL 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 in der [app].runtimeconfig.json Konfigurationsdatei festfalse:

  {
    "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

• ImageLocation