Icon.ExtractAssociatedIcon(String) Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

Icon.cs

Возвращает представление изображения, содержащегося в заданном файле, в виде значка.

public:
 static System::Drawing::Icon ^ ExtractAssociatedIcon(System::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

Параметры

filePath

String

Путь к файлу, содержащему изображение.

Возвращаемое значение

Icon

Представление Icon изображения, содержащегося в заданном файле.

Исключения

ArgumentException

Параметр filePath не указывает на правильный файл.

-или-

Параметр filePath задает путь в формате UNC.

Примеры

В следующем примере кода показано, как использовать метод ExtractAssociatedIcon. Чтобы запустить этот пример, вставьте код в форму Windows Forms и вызовите ExtractAssociatedIconEx из конструктора или Load обработчика событий формы.

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

Комментарии

Предполагается, что относительный путь относится к текущему рабочему каталогу.

Если ExtractAssociatedIcon используется с растровыми изображениями, вместо значка может быть возвращен эскиз, если в системе, в котором выполняется приложение, есть параметр реестра, который приводит к отображению точечных файлов в виде эскизов.