Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Icon.ExtractAssociatedIcon(String) Method

Definition

Gibt eine Symboldarstellung eines Bilds zurück, das in der angegebenen Datei enthalten ist. 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

Parameter

filePath
String String String String

Der Pfad zu der Datei, die ein Bild enthält. The path to the file that contains an image.

Returns

Die Icon-Darstellung des in der angegebenen Datei enthaltenen Bilds. The Icon representation of the image that is contained in the specified file.

Exceptions

Der filePath gibt keine gültige Datei an. The filePath does not indicate a valid file. - oder - -or- Der filePath gibt einen UNC (Universal Naming Convention)-Pfad an. The filePath indicates a Universal Naming Convention (UNC) path.

Examples

Das folgende Codebeispiel zeigt, wie Sie die ExtractAssociatedIcon-Methode verwenden.The following code example demonstrates how to use the ExtractAssociatedIcon method. Um dieses Beispiel auszuführen, fügen Sie den Code in einem Windows Form, und rufen ExtractAssociatedIconEx aus den Konstruktor des Formulars oder Load -Ereignishandler.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

Remarks

Ein relativer Pfad wird als relativ zum aktuellen Arbeitsverzeichnis.A relative path is assumed to be relative to the current working directory.

Wenn ExtractAssociatedIcon wird verwendet, mit Bitmaps, kann ein Miniaturbild anstelle eines Symbols zurückgegeben werden, wenn das System, das die Anwendung ausgeführt wird, einen Registrierungseintrag aufweist, bei dem Bitmap-Dateien als Miniaturansichten angezeigt werden.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.

Applies to