Icon.ExtractAssociatedIcon(String) Método

Definición

Devuelve una representación de icono de una imagen que está incluida en el archivo especificado.

public:
 static System::Drawing::Icon ^ ExtractAssociatedIcon(System::String ^ filePath);
public static System.Drawing.Icon ExtractAssociatedIcon (string filePath);
public static System.Drawing.Icon? ExtractAssociatedIcon (string filePath);
static member ExtractAssociatedIcon : string -> System.Drawing.Icon
Public Shared Function ExtractAssociatedIcon (filePath As String) As Icon

Parámetros

filePath
String

Ruta de acceso al archivo que contiene una imagen.

Devoluciones

Representación Icon de la imagen que está incluida en el archivo especificado.

Excepciones

filePath no indica un archivo válido.

o bien

filePath indica una ruta de acceso UNC (Convención de nomenclatura universal).

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método ExtractAssociatedIcon. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame ExtractAssociatedIconEx desde el constructor o Load controlador de eventos del formulario.

private void ExtractAssociatedIconEx()
{
    Icon ico =
        Icon.ExtractAssociatedIcon(@"C:\WINDOWS\system32\notepad.exe");
    this.Icon = ico;
}
Private Sub ExtractAssociatedIconEx()
    Dim ico As Icon = Icon.ExtractAssociatedIcon("C:\WINDOWS\system32\notepad.exe")
    Me.Icon = ico

End Sub

Comentarios

Se supone que una ruta de acceso relativa es relativa al directorio de trabajo actual.

Cuando ExtractAssociatedIcon se usa con mapas de bits, se puede devolver una imagen en miniatura en lugar de un icono si el sistema que ejecuta la aplicación tiene una configuración del Registro que hace que los archivos de mapa de bits se muestren como imágenes en miniatura.

Se aplica a