PictureBox.Load Método

Definición

Muestra una imagen en el control PictureBox.

Sobrecargas

Load()

Muestra la imagen especificada por la propiedad ImageLocation de PictureBox.

Load(String)

Establece la propiedad ImageLocation en la dirección URL especificada y muestra la imagen indicada.

Load()

Muestra la imagen especificada por la propiedad ImageLocation de PictureBox.

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

Excepciones

ImageLocation es null o una cadena vacía.

Comentarios

A partir de .NET 8, el comportamiento de cómo un PictureBox control carga una imagen remota ha cambiado. De forma predeterminada, la System.Net.ServicePointManager.CheckCertificateRevocationList propiedad se establece true en antes de que se descargue una imagen remota a través WebClientde . Esta configuración garantiza que los servidores con certificados tengan esos certificados comprobados en la lista de revocación de la entidad de certificación (CRL) como parte del proceso de validación.

Advertencia

En cuanto se carga una imagen remota, CheckCertificateRevocationList se cambia a true durante la vigencia de la aplicación. Puede revertir manualmente false si es necesario, pero en cuanto se carga otra imagen remota, CheckCertificateRevocationList se establece en true.

Es posible que un recurso remoto de trabajo anterior no se cargue cuando la CRL almacenada localmente en caché está obsoleta y no se puede recuperar una actualización. Esto puede ocurrir cuando la red en la que se ejecuta la aplicación está restringida y la ubicación crL no está en la lista de permitidos.

También es posible que el retraso en la comprobación de la CRL afecte negativamente a la capacidad de la aplicación para funcionar.

Puede no participar en este comportamiento estableciendo la System.Windows.Forms.ServicePointManagerCheckCrl opción para la aplicación de una de las maneras siguientes:

  • Establezca la propiedad false en en el archivo de configuración [app].runtimeconfig.json :

    {
      "configProperties": {
        "System.Windows.Forms.ServicePointManagerCheckCrl": false
      }
    }
    
  • Agregue un <RuntimeHostConfigurationOption> elemento en el archivo de proyecto para deshabilitarlo:

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

Consulte también

Se aplica a

Load(String)

Establece la propiedad ImageLocation en la dirección URL especificada y muestra la imagen indicada.

public:
 void Load(System::String ^ url);
public void Load (string url);
member this.Load : string -> unit
Public Sub Load (url As String)

Parámetros

url
String

Ruta de acceso de la imagen que se va a mostrar en PictureBox.

Excepciones

url es null o una cadena vacía.

url hace referencia a una imagen en la Web a la que no se puede tener acceso.

url hace referencia a un archivo que no es una imagen.

url hace referencia a un archivo que no existe.

Comentarios

Si el url parámetro indica un archivo local, el formato recomendado es una ruta de acceso del archivo local. Por ejemplo, se tendría acceso a un archivo de imagen denominado myPicture.jpg ubicado en c:\ pasando c:\myPicture.jpg para el url parámetro . Se puede usar una ruta de acceso completa, como http://www.contoso.com/path/images/image.jpg, o una ruta de acceso relativa, como ./images/image.jpg. Si se usa una ruta de acceso relativa, se considerará relativa al directorio de trabajo. Una llamada al Load método establece la ImageLocation propiedad en el valor del url parámetro .

Cambios de comportamiento de carga

A partir de .NET 8, el comportamiento de cómo un PictureBox control carga una imagen remota ha cambiado. De forma predeterminada, la System.Net.ServicePointManager.CheckCertificateRevocationList propiedad se establece true en antes de que se descargue una imagen remota a través WebClientde . Esta configuración garantiza que los servidores con certificados tengan esos certificados comprobados en la lista de revocación de la entidad de certificación (CRL) como parte del proceso de validación.

Advertencia

En cuanto se carga una imagen remota, CheckCertificateRevocationList se cambia a true durante la vigencia de la aplicación. Puede revertir manualmente false si es necesario, pero en cuanto se carga otra imagen remota, CheckCertificateRevocationList se establece en true.

Es posible que un recurso remoto de trabajo anterior no se cargue cuando la CRL almacenada localmente en caché está obsoleta y no se puede recuperar una actualización. Esto puede ocurrir cuando la red en la que se ejecuta la aplicación está restringida y la ubicación crL no está en la lista de permitidos.

También es posible que el retraso en la comprobación de la CRL afecte negativamente a la capacidad de la aplicación para funcionar.

Puede no participar en este comportamiento estableciendo la System.Windows.Forms.ServicePointManagerCheckCrl opción para la aplicación de una de las maneras siguientes:

  • Establezca la propiedad false en en el archivo de configuración [app].runtimeconfig.json :

    {
      "configProperties": {
        "System.Windows.Forms.ServicePointManagerCheckCrl": false
      }
    }
    
  • Agregue un <RuntimeHostConfigurationOption> elemento en el archivo de proyecto para deshabilitarlo:

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

Consulte también

Se aplica a