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

Das folgende Beispiel zeigt, wie Sie Daten in die Zwischenablage des Systems hinzufügen.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 Systemzwischenablage freigeben, damit der Inhalt vorbehalten ist, wenn Sie in 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 Formaten zur Verfügung, mit der Clipboard Klasse, finden Sie unter den DataFormats Klasse.For a list of predefined formats available to use with the Clipboard class, see the DataFormats class.

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

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

  • Kopie kann nur für vom Benutzer ausgewählten Inhalt sein.Copy can only be on user selected content.

  • Beim Kopieren oder Ausschneiden, teilweise vertrauenswürdigem Code fügt den nur-Text und Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) der Zwischenablage gespeichert.On copy or cut, partial trust code puts plaintext and Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) on to the clipboard. Nur-Text enthält Text, Unicode-Text, OEM (Object Exchange Model)-Text und CSV (durch Trennzeichen getrennte Werte).Plaintext includes text, Unicode text, OEM (Object Exchange Model) text, and CSV (Comma-separated values).

  • Beim Einfügen Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) wird, fügen Sie in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) , wenn die Quelle der, dass der Inhalt von einem Standort gleichermaßen vertrauenswürdig oder mehr vertraut 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 einfügen kann Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) aus einer Anwendung volle Vertrauenswürdigkeit.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 einfügen kann Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) in einer teilweise vertrauenswürdigen Anwendung.A partial trust application can paste Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) from a partial trust application.

    • Voll vertrauenswürdige Anwendung kann XAML nur über eine voll vertrauenswürdige Anwendung einfügen.A full trust application can paste XAML only from another fully trusted application.

    • NichtWindows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) voll vertrauenswürdige Anwendung ApplicationTrust-Format in der Zwischenablage überprüfen und ggf. das XAML bereinigen kann.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 Zwischenablage des Systems.Clears any data from the system Clipboard.

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

Fragt die Zwischenablage auf das Vorhandensein von Daten in die WaveAudio Datenformat.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.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 in die FileDrop Datenformat.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 in die Bitmap Datenformat.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 in die UnicodeText Format.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()

Dauerhaft fügt die Daten, die auf die Clipboard , damit sie nach dem die Daten der ursprünglichen Anwendung geschlossen verfügbar ist.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 der WaveAudio Datenformat.Returns a stream of Clipboard data in the WaveAudio data format.

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

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

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

Gibt ein Objekt, 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 Auflistung von Zeichenfolgen, die eine Liste der abgelegten Dateien in der Zwischenablage enthält.Returns a string collection that contains a list of dropped files available on the Clipboard.

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

Gibt eine BitmapSource Objekt aus der Zwischenablage an, die Daten in enthält die Bitmap Format.Returns a BitmapSource object from the Clipboard that contains data in the Bitmap format.

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

Gibt eine Zeichenfolge mit der UnicodeText Daten in die Zwischenablage.Returns a string containing the UnicodeText data on the Clipboard.

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

Gibt eine Zeichenfolge, 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 an.Compares a specified data object to the contents of the Clipboard.

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

Speichert Audiodaten (WaveAudio Datenformat) in die 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 die 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 in der Zwischenablage im angegebenen Format.Stores the specified data on the Clipboard in the specified format.

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

Platziert ein angegebenes nicht persistent gespeicherte 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, 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 die Zwischenablage.Stores FileDrop data on the Clipboard. 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 die Zwischenablage.Stores Bitmap data on the Clipboard. Die Image-Daten angegeben ist, als eine BitmapSource.The image data is specified as a BitmapSource.

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

Speichert UnicodeText Daten in die 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 UnicodeText zu speichernden Daten als Zeichenfolge angegeben ist.The UnicodeText data to store is specified as a string.

Gilt für:

Siehe auch