Icon.ExtractAssociatedIcon(String) Methode

Definition

Gibt eine Symboldarstellung eines Bildes 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

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

Gibt zurück

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

Ausnahmen

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.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ExtractAssociatedIcon-Methode verwenden.The following code example demonstrates how to use the ExtractAssociatedIcon method. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form ein, ExtractAssociatedIconEx und nennen Sie ihn aus dem Konstruktor oder Load Ereignishandler des Formulars.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

Hinweise

Es wird davon ausgegangen, dass ein relativer Pfad relativ zum aktuellen Arbeitsverzeichnis ist.A relative path is assumed to be relative to the current working directory.

Wenn ExtractAssociatedIcon mit Bitmaps verwendet wird, kann anstelle eines Symbols ein Miniaturbild zurückgegeben werden, wenn das System, auf dem die Anwendung ausgeführt wird, über eine Registrierungs Einstellung verfügt, die bewirkt, dass Bitmapdateien als Miniaturbilder 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.

Gilt für: