Clipboard Klasse

Definition

Stellt statische Methoden bereit, die die Übertragung von Daten in die und aus der Zwischenablage des Systems erleichtern.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Vererbung
Clipboard

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie der Systemablage Daten hinzufügen.


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);
' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

Hinweise

Alle Anwendungen für Windows teilen sich die Systemablage, sodass sich der Inhalt ändern kann, wenn Sie zu einer anderen Anwendung wechseln.

Eine Liste der vordefinierten Formate, die für die Verwendung mit der Clipboard -Klasse verfügbar sind, finden Sie in der DataFormats -Klasse.

Sicherheitswarnung: Aus Sicherheitsgründen sollten die folgenden Punkte beachtet werden.

  • Einfügevorgänge müssen vom Benutzer initiiert werden (STRG-V, Menü einfügen).

  • Kopieren kann nur für vom Benutzer ausgewählte Inhalte erfolgen.

  • Beim Kopieren oder Ausschneiden fügt teilweise vertrauenswürdiger Code Klartext und XAML (Extensible Application Markup Language) in die Zwischenablage ein. Klartext umfasst Text, Unicode-Text, OEM-Text (Object Exchange Model) und CSV (durch Trennzeichen getrennte Werte).

  • Beim Einfügen wird Windows Presentation Foundation (WPF) in XAML (Extensible Application Markup Language) eingefügt, wenn die Quelle dieses Inhalts von einer ebenso vertrauenswürdigen oder vertrauenswürdigen Website stammt. Dies gilt insbesondere in folgenden Fällen:

    • Eine teilweise vertrauenswürdige Anwendung kann XAML (Extensible Application Markup Language) aus einer voll vertrauenswürdigen Anwendung einfügen.

    • Eine teilweise vertrauenswürdige Anwendung kann XAML (Extensible Application Markup Language) aus einer teilweise vertrauenswürdigen Anwendung einfügen.

    • Eine voll vertrauenswürdige Anwendung kann XAML nur aus einer anderen vollständig vertrauenswürdigen Anwendung einfügen.

    • Eine nicht Windows Presentation Foundation (WPF) voll vertrauenswürdige Anwendung kann das ApplicationTrust-Format in der Zwischenablage untersuchen und ggf. den XAML-Code bereinigen.

Methoden

Clear()

Löscht alle Daten aus der Systemzwischenablage.

ContainsAudio()

Fragt die Zwischenablage auf das Vorhandensein von Daten im WaveAudio-Datenformat ab.

ContainsData(String)

Fragt die Zwischenablage auf das Vorhandensein von Daten in einem angegebenen Datenformat ab.

ContainsFileDropList()

Fragt die Zwischenablage auf das Vorhandensein von Daten im FileDrop-Datenformat ab.

ContainsImage()

Fragt die Zwischenablage auf das Vorhandensein von Daten im Bitmap-Datenformat ab.

ContainsText()

Fragt die Zwischenablage auf das Vorhandensein von Daten im UnicodeText-Format ab.

ContainsText(TextDataFormat)

Fragt die Zwischenablage auf das Vorhandensein von Daten in einem Textdatenformat ab.

Flush()

Fügt die Daten dauerhaft hinzu, die sich auf Clipboard befinden, sodass sie verfügbar ist, nachdem die ursprüngliche Anwendung der Daten geschlossen wird.

GetAudioStream()

Gibt einen Stream mit Zwischenablagedaten im WaveAudio-Datenformat zurück.

GetData(String)

Ruft Daten in einem angegebenen Format aus der Zwischenablage ab.

GetDataObject()

Gibt ein Datenobjekt zurück, das den gesamten Inhalt der Zwischenablage darstellt.

GetFileDropList()

Gibt eine Zeichenfolgenauflistung zurück, die eine Liste der in der Zwischenablage verfügbaren abgelegten Dateien enthält.

GetImage()

Gibt ein BitmapSource-Objekt aus der Zwischenablage zurück, das Daten im Bitmap-Format enthält.

GetText()

Gibt eine Zeichenfolge zurück, die die UnicodeText-Daten in der Zwischenablage enthält.

GetText(TextDataFormat)

Gibt eine Zeichenfolge zurück, die die Textdaten in der Zwischenablage enthält.

IsCurrent(IDataObject)

Vergleicht ein angegebenes Datenobjekt mit dem Inhalt der Zwischenablage.

SetAudio(Byte[])

Speichert Audiodaten (WaveAudio-Datenformat) in der Zwischenablage. Die Audiodaten werden als Bytearray angegeben.

SetAudio(Stream)

Speichert Audiodaten (WaveAudio-Datenformat) in der Zwischenablage. Die Audiodaten werden als Stream angegeben.

SetData(String, Object)

Speichert die angegebenen Daten im angegebenen Format in der Zwischenablage.

SetDataObject(Object)

Platziert ein angegebenes nicht permanentes Datenobjekt in der Systemzwischenablage.

SetDataObject(Object, Boolean)

Platziert ein angegebenes Datenobjekt in der Systemzwischenablage und nimmt einen booleschen Parameter an, der angibt, ob das Datenobjekt beim Beenden der Anwendung in der Zwischenablage belassen werden soll.

SetFileDropList(StringCollection)

Speichert FileDrop-Daten in der Zwischenablage. Die Liste der abgelegten Dateien wird als Zeichenfolgenauflistung angegeben.

SetImage(BitmapSource)

Speichert Bitmap-Daten in der Zwischenablage. Die Bilddaten werden als BitmapSource angegeben.

SetText(String)

Speichert UnicodeText-Daten in der Zwischenablage.

SetText(String, TextDataFormat)

Speichert Textdaten in der Zwischenablage in einem angegebenen Textdatenformat. Die zu speichernden UnicodeText-Daten werden als Zeichenfolge angegeben.

Gilt für:

Weitere Informationen