Clipboard.SetData(String, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht die Zwischenablage und fügt dann Daten im angegebenen Format hinzu.
public:
static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData (string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)
Parameter
- format
- String
Das Format der festzulegenden Daten. Vordefinierte Formate finden Sie unter DataFormats.
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main
-Methode der Anwendung das STAThreadAttribute hinzu.
data
ist null
.
Beispiele
Im folgenden Beispiel wird dieses Element veranschaulicht.
// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
Object returnObject = null;
if (Clipboard.ContainsData(format))
{
returnObject = Clipboard.GetData(format);
Clipboard.SetData(format, data);
}
return returnObject;
}
' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
ByVal format As String, ByVal data As Object) As Object
Dim returnObject As Object = Nothing
If (Clipboard.ContainsData(format)) Then
returnObject = Clipboard.GetData(format)
Clipboard.SetData(format, data)
End If
Return returnObject
End Function
Hinweise
Wenn Sie das Format der Zielanwendung nicht kennen, können Sie Mit dieser Methode Daten in mehreren Formaten speichern.
Mit dieser Methode gespeicherte Daten können beim Abrufen in ein kompatibles Format konvertiert werden.
Um Daten aus der Zwischenablage in einem bestimmten Format abzurufen, verwenden Sie zunächst die ContainsData -Methode, um zu bestimmen, ob die Zwischenablage Daten in diesem Format enthält, bevor Sie sie mit der GetData -Methode abrufen.
Hinweis
Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main
-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.