Speichern von Daten in der Zwischenablage und Lesen von Daten aus der Zwischenablage (Visual Basic)Storing data to and reading from the Clipboard (Visual Basic)

Die Zwischenablage kann zum Speichern von Daten, z.B. Texten und Bildern, verwendet werden.The Clipboard can be used to store data, such as text and images. Da die Zwischenablage von allen aktiven Prozessen genutzt wird, kann sie zur Übertragung von Daten zwischen den Prozessen verwendet werden.Because the Clipboard is shared by all active processes, it can be used to transfer data between them. Mit dem Objekt My.Computer.Clipboard können Sie einfach auf die Zwischenablage zugreifen, aus ihr lesen sowie in sie schreiben.The My.Computer.Clipboard object allows you to easily access the Clipboard and to read from and write to it.

Lesen aus der ZwischenablageReading from the Clipboard

Verwenden Sie die GetText-Methode, um den Text in der Zwischenablage auszulesen.Use the GetText method to read the text in the Clipboard. Der folgende Code liest den Text aus und zeigt ihn in einem Nachrichtenfeld an.The following code reads the text and displays it in a message box. Es muss Text in der Zwischenablage gespeichert sein, damit das Beispiel richtig ausgeführt wird.There must be text stored on the Clipboard for the example to run correctly.

MsgBox(My.Computer.Clipboard.GetText())

Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar.This code example is also available as an IntelliSense code snippet. Er befindet sich in der Codeausschnittauswahl unter Windows Forms-Anwendungen > Zwischenablage.In the code snippet picker, it is located in Windows Forms Applications > Clipboard. Weitere Informationen finden Sie unter Codeausschnitte.For more information, see Code Snippets.

Verwenden Sie die GetImage-Methode zum Abrufen eines Bilds aus der Zwischenablage.Use the GetImage method to retrieve an image from the Clipboard. In diesem Beispiel wird überprüft, ob ein Bild in der Zwischenablage ist, bevor es abgerufen und PictureBox1 zugewiesen wird.This example checks to see if there is an image on the Clipboard before retrieving it and assigning it to PictureBox1.

If My.Computer.Clipboard.ContainsImage() Then
  Dim grabpicture As System.Drawing.Image
  grabpicture = My.Computer.Clipboard.GetImage()
  picturebox1.Image = grabpicture
End If

Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar.This code example is also available as an IntelliSense code snippet. Es befindet sich in der Codeausschnittauswahl unter Windows Forms-Anwendungen > Zwischenablage. Weitere Informationen finden Sie unter Codeausschnitte.In the code snippet picker, it is located in Windows Forms Applications > Clipboard.For more information, see Code Snippets.

Elemente, die in die Zwischenablage gelegt wurden, bleiben dort, auch nachdem die Anwendung heruntergefahren wurde.Items placed on the Clipboard will persist even after the application is shut down.

Bestimmen des Dateityps, der in der Zwischenablage gespeichert istDetermining the type of file stored in the Clipboard

Daten in der Zwischenablage können eine Anzahl von verschiedenen Formen annehmen, z.B. eine Audiodatei oder ein Bild.Data on the Clipboard may take a number of different forms, such as text, an audio file, or an image. Um zu ermitteln, welche Art von Datei sich in der Zwischenablage befindet, können Sie Methoden wie z.B. ContainsAudio, ContainsFileDropList, ContainsImage und ContainsText verwenden.In order to determine what sort of file is on the Clipboard, you can use methods such as ContainsAudio, ContainsFileDropList, ContainsImage, and ContainsText. Die ContainsData-Methode kann verwendet werden, wenn Sie ein benutzerdefiniertes Format überprüfen möchten.The ContainsData method can be used if you have a custom format that you want to check.

Verwenden Sie die ContainsImage-Funktion, um zu bestimmen, ob die Daten in der Zwischenablage ein Bild sind.Use the ContainsImage function to determine whether the data contained on the Clipboard is an image. Der folgende Code überprüft, ob die Daten ein Bild sind und erstattet dementsprechend Bericht.The following code checks to see whether the data is an image and reports accordingly.

If My.Computer.Clipboard.ContainsImage() Then
    MsgBox("Clipboard contains an image.")
Else
    MsgBox("Clipboard does not contain an image.")
End If

Löschen der ZwischenablageClearing the Clipboard

Die Clear-Methode löscht den Inhalt der Zwischenablage.The Clear method clears the Clipboard. Da die Zwischenablage von anderen Prozessen gleichzeitig verwendet wird, kann sich das Löschen auf diese Prozesse auswirken.Because the Clipboard is shared by other processes, clearing it may have an impact on those processes.

Im folgenden Code wird die Verwendung der Clear-Methode veranschaulicht.The following code shows how to use the Clear method.

My.Computer.Clipboard.Clear()

In die Zwischenablage schreibenWriting to the Clipboard

Verwenden Sie die SetText-Methode, um Text in die Zwischenablage zu schreiben.Use the SetText method to write text to the Clipboard. Der folgende Code schreibt die Zeichenfolge „Das ist eine Testzeichenfolge“ in die Zwischenablage.The following code writes the string "This is a test string" to the Clipboard.

My.Computer.Clipboard.SetText("This is a test string.")

Die SetText-Methode kann einen Formatparameter akzeptieren, der einen Typ von TextDataFormat enthält.The SetText method can accept a format parameter that contains a type of TextDataFormat. Der folgende Code schreibt die Zeichenfolge „Das ist eine Testzeichenfolge“ als RTF-Text in die Zwischenablage.The following code writes the string "This is a test string" to the Clipboard as RTF text.

My.Computer.Clipboard.SetText("This is a test string.", 
System.Windows.Forms.TextDataFormat.Rtf)

Verwenden Sie die SetData-Methode, um Daten in die Zwischenablage zu schreiben.Use the SetData method to write data to the Clipboard. In diesem Beispiel wird das DataObject``dataChunk im benutzerdefiniertem Format specialFormat in die Zwischenablage geschrieben.This example writes the DataObject``dataChunk to the Clipboard in the custom format specialFormat.

My.Computer.Clipboard.SetData("specialFormat", dataChunk)

Verwenden Sie die SetAudio-Methode, um Audiodaten in die Zwischenablage zu schreiben.Use the SetAudio method to write audio data to the Clipboard. In diesem Beispiel wird das Bytearray musicReader erstellt, die Datei cool.wav darin gelesen und anschließend in die Zwischenablage geschrieben.This example creates the byte array musicReader, reads the file cool.wav into it, and then writes it to the Clipboard.

Dim musicReader = My.Computer.FileSystem.ReadAllBytes("cool.wav")
My.Computer.Clipboard.SetAudio(musicReader)

Wichtig

Da auf die Zwischenablage von anderen Benutzern zugegriffen werden kann, verwenden Sie sie nicht, um sensible Informationen wie Passwörter oder vertrauliche Daten zu speichern.Because the Clipboard can be accessed by other users, do not use it to store sensitive information, such as passwords or confidential data.

Siehe auchSee also

ClipboardProxy
GetAudioStream
SetDataObject
Gewusst wie: Lesen von Objektdaten aus einer XML-DateiHow to: Read Object Data from an XML File
Gewusst wie: Schreiben von Objektdaten in eine XML-DateiHow to: Write Object Data to an XML File