Icon.ExtractAssociatedIcon(String) Methode

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.dll

Gibt eine Symboldarstellung eines Bilds zurück, das in der angegebenen Datei enthalten ist.

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.

Gibt zurück

Icon

Die Icon Darstellung des Bilds, das in der angegebenen Datei enthalten ist.

Ausnahmen

ArgumentException

Die filePath Datei gibt keine gültige Datei an.

-oder-

Der filePath Pfad gibt einen UNC-Pfad (Universal Naming Convention) an.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ExtractAssociatedIcon Methode veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den Code in ein Windows Form-Formular ein, und rufen Sie ExtractAssociatedIconEx den Konstruktor oder Load Den Ereignishandler des Formulars auf.

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

Ein relativer Pfad wird als relativ zum aktuellen Arbeitsverzeichnis angenommen.

Wenn ExtractAssociatedIcon sie mit Bitmaps verwendet wird, wird möglicherweise anstelle eines Symbols ein Miniaturbild zurückgegeben, wenn das System, das die Anwendung ausführt, über eine Registrierungseinstellung verfügt, die bewirkt, dass Bitmapdateien als Miniaturansichten angezeigt werden.

Gilt für: