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 Daten zur Systemablage hinzugefügt werden.


// 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 die Systemablage freigeben, sodass der Inhalt geändert werden kann, wenn Sie zu einer anderen Anwendung wechseln.

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

Sicherheitswarnung: Für Sicherheitszwecke sollten die folgenden Punkte beachtet werden.

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

  • Kopieren kann nur auf ausgewählten Inhalten des Benutzers erfolgen.

  • Beim Kopieren oder Ausschneiden fügt Teilvertrauenswürdiger Code Nurtext und Extensible Application Markup Language (XAML) in die Zwischenablage ein. Nurtext enthält Text, Unicode-Text, OEM (Objekt Exchange Modell)-Text und CSV (Trennzeichenwerte).

  • Bei der Einfüge fügt Windows Presentation Foundation (WPF) in Extensible Application Markup Language (XAML) ein, wenn die Quelle dieser Inhalte aus einer gleich vertrauenswürdigen oder vertrauenswürdigen Website stammt. Dies gilt insbesondere in folgenden Fällen:

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

    • Eine teilvertrauenswürdige Anwendung kann extensible Application Markup Language (XAML) aus einer teilvertrauenswürdigen Anwendung einfügen.

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

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

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

Siehe auch