Icon.ExtractAssociatedIcon(String) Метод

Определение

Возвращает представление изображения, содержащегося в заданном файле, в виде значка.Returns an icon representation of an image that is contained in the specified file.

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

Путь к файлу, содержащему изображение.The path to the file that contains an image.

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

Icon

Представление Icon изображения, содержащегося в заданном файле.The Icon representation of the image that is contained in the specified file.

Исключения

Параметр filePath не указывает на правильный файл.The filePath does not indicate a valid file.

-или--or- Параметр filePath задает путь в формате UNC.The filePath indicates a Universal Naming Convention (UNC) path.

Примеры

В следующем примере кода показано, как использовать метод ExtractAssociatedIcon.The following code example demonstrates how to use the ExtractAssociatedIcon method. Чтобы выполнить этот пример, вставьте код в форму Windows Forms и вызовите ExtractAssociatedIconEx из конструктора формы или обработчика событий Load.To run this example, paste the code into a Windows Form and call ExtractAssociatedIconEx from the form's constructor or Load event handler.

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

Комментарии

Предполагается, что относительный путь относится к текущему рабочему каталогу.A relative path is assumed to be relative to the current working directory.

Если ExtractAssociatedIcon используется с точечными рисунками, вместо значка может возвращаться изображение эскиза, если в системе, где работает приложение, есть параметр реестра, который приводит к отображению растровых изображений в виде эскизов.When ExtractAssociatedIcon is used with bitmaps, a thumbnail image may be returned instead of an icon if the system that is running the application has a registry setting that causes bitmap files to be shown as thumbnail images.

Применяется к