Clipboard Clipboard Clipboard Clipboard Class

Definition

Stellt statische Methoden bereit, die die Übertragung von Daten in die und aus der Zwischenablage des Systems erleichtern.Provides static methods that facilitate transferring data to and from the system Clipboard.

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie Daten der System Zwischenablage hinzugefügt werden.The following example shows how to add data to the system Clipboard.


// 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 WindowsWindows geben die System Zwischenablage frei, sodass der Inhalt geändert werden kann, wenn Sie zu einer anderen Anwendung wechseln.All applications for WindowsWindows share the system Clipboard, so the contents are subject to change when you switch to another application.

Eine Liste der vordefinierten Formate, die zur Verwendung mit der Clipboard -Klasse verfügbar sind DataFormats , finden Sie unter der-Klasse.For a list of predefined formats available to use with the Clipboard class, see the DataFormats class.

Sicherheitswarnung: Aus Sicherheitsgründen sollten die folgenden Punkte berücksichtigt werden.Security Alert: For security purposes, the following points should be kept in mind.

  • Einfügevorgänge müssen vom Benutzer initiiert werden (STRG + V, Menü Einfügen).Paste operations need to be user initiated (Ctrl-V, Paste Menu).

  • Der Kopiervorgang kann nur auf vom Benutzer ausgewählten Inhalt erfolgen.Copy can only be on user selected content.

  • Beim Kopieren oder Ausschneiden legt teilweise vertrauenswürdiger Code Klartext und Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) in die Zwischenablage ein.On copy or cut, partial trust code puts plaintext and Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) on to the clipboard. Klartext schließt Text, Unicode-Text, OEM-Text (Objekt Austauschmodell) und CSV (durch Trennzeichen getrennte Werte) ein.Plaintext includes text, Unicode text, OEM (Object Exchange Model) text, and CSV (Comma-separated values).

  • Fügt beim Einfügen Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) ein, Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) wenn die Quelle dieses Inhalts von einer gleichermaßen vertrauenswürdigen oder einer vertrauenswürdigeren Website ist.On paste, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) will paste in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) if the source of that content is from a equally trusted or more trusted site. Dies gilt insbesondere in folgenden Fällen:Specifically:

    • Eine teilweise vertrauenswürdige Anwendung kann Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) aus einer Anwendung mit voller Vertrauenswürdigkeit eingefügt werden.A partial trust application can paste Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) from a full trust application.

    • Eine teilweise vertrauenswürdige Anwendung kann Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) aus einer teilweise vertrauenswürdigen Anwendung eingefügt werden.A partial trust application can paste Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) from a partial trust application.

    • Eine Anwendung mit voller Vertrauenswürdigkeit kann XAML nur aus einer anderen voll vertrauenswürdigen Anwendung einfügen.A full trust application can paste XAML only from another fully trusted application.

    • Eine Anwendung,Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) die nicht vollständig vertrauenswürdig ist, kann das ApplicationTrust-Format in der Zwischenablage untersuchen und ggf. die XAML bereinigen.A non-Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) full trust application can examine the ApplicationTrust format on the clipboard and sanitize the XAML if appropriate.

Methoden

Clear() Clear() Clear() Clear()

Löscht alle Daten aus der Systemzwischenablage.Clears any data from the system Clipboard.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

Fragt die Zwischenablage auf das Vorhandensein von Daten im WaveAudio-Datenformat ab.Queries the Clipboard for the presence of data in the WaveAudio data format.

ContainsData(String) ContainsData(String) ContainsData(String) ContainsData(String)

Fragt die Zwischenablage auf das Vorhandensein von Daten in einem angegebenen Datenformat ab.Queries the Clipboard for the presence of data in a specified data format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

Fragt die Zwischenablage auf das Vorhandensein von Daten im FileDrop-Datenformat ab.Queries the Clipboard for the presence of data in the FileDrop data format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Fragt die Zwischenablage auf das Vorhandensein von Daten im Bitmap-Datenformat ab.Queries the Clipboard for the presence of data in the Bitmap data format.

ContainsText() ContainsText() ContainsText() ContainsText()

Fragt die Zwischenablage auf das Vorhandensein von Daten im UnicodeText-Format ab.Queries the Clipboard for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

Fragt die Zwischenablage auf das Vorhandensein von Daten in einem Textdatenformat ab.Queries the Clipboard for the presence of data in a text data format.

Flush() Flush() Flush() 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.Permanently adds the data that is on the Clipboard so that it is available after the data's original application closes.

GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

Gibt einen Stream mit Zwischenablagedaten im WaveAudio-Datenformat zurück.Returns a stream of Clipboard data in the WaveAudio data format.

GetData(String) GetData(String) GetData(String) GetData(String)

Ruft Daten in einem angegebenen Format aus der Zwischenablage ab.Retrieves data in a specified format from the Clipboard.

GetDataObject() GetDataObject() GetDataObject() GetDataObject()

Gibt ein Datenobjekt zurück, das den gesamten Inhalt der Zwischenablage darstellt.Returns a data object that represents the entire contents of the Clipboard.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

Gibt eine Zeichenfolgenauflistung zurück, die eine Liste der in der Zwischenablage verfügbaren abgelegten Dateien enthält.Returns a string collection that contains a list of dropped files available on the Clipboard.

GetImage() GetImage() GetImage() GetImage()

Gibt ein BitmapSource-Objekt aus der Zwischenablage zurück, das Daten im Bitmap-Format enthält.Returns a BitmapSource object from the Clipboard that contains data in the Bitmap format.

GetText() GetText() GetText() GetText()

Gibt eine Zeichenfolge zurück, die die UnicodeText-Daten in der Zwischenablage enthält.Returns a string containing the UnicodeText data on the Clipboard.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

Gibt eine Zeichenfolge zurück, die die Textdaten in der Zwischenablage enthält.Returns a string containing text data on the Clipboard.

IsCurrent(IDataObject) IsCurrent(IDataObject) IsCurrent(IDataObject) IsCurrent(IDataObject)

Vergleicht ein angegebenes Datenobjekt mit dem Inhalt der Zwischenablage.Compares a specified data object to the contents of the Clipboard.

SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

Speichert Audiodaten (WaveAudio-Datenformat) in der Zwischenablage.Stores audio data (WaveAudio data format) on the Clipboard. Die Audiodaten werden als Bytearray angegeben.The audio data is specified as a byte array.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

Speichert Audiodaten (WaveAudio-Datenformat) in der Zwischenablage.Stores audio data (WaveAudio data format) on the Clipboard. Die Audiodaten werden als Stream angegeben.The audio data is specified as a stream.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

Speichert die angegebenen Daten im angegebenen Format in der Zwischenablage.Stores the specified data on the Clipboard in the specified format.

SetDataObject(Object) SetDataObject(Object) SetDataObject(Object) SetDataObject(Object)

Platziert ein angegebenes nicht permanentes Datenobjekt in der Systemzwischenablage.Places a specified non-persistent data object on the system Clipboard.

SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) 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.Places a specified data object on the system Clipboard and accepts a Boolean parameter that indicates whether the data object should be left on the Clipboard when the application exits.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

Speichert FileDrop-Daten in der Zwischenablage.Stores FileDrop data on the Clipboard. Die Liste der abgelegten Dateien wird als Zeichenfolgenauflistung angegeben.The dropped file list is specified as a string collection.

SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource)

Speichert Bitmap-Daten in der Zwischenablage.Stores Bitmap data on the Clipboard. Die Bilddaten werden als BitmapSource angegeben.The image data is specified as a BitmapSource.

SetText(String) SetText(String) SetText(String) SetText(String)

Speichert UnicodeText-Daten in der Zwischenablage.Stores UnicodeText data on the Clipboard.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

Speichert Textdaten in der Zwischenablage in einem angegebenen Textdatenformat.Stores text data on the Clipboard in a specified text data format. Die zu speichernden UnicodeText-Daten werden als Zeichenfolge angegeben.The UnicodeText data to store is specified as a string.

Gilt für:

Siehe auch