Clipboard.SetData(String, Object) Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Clipboard.cs

Törli a vágólapot, majd a megadott formátumban adja hozzá az adatokat.

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)

Paraméterek

format

String

A beállítani kívánt adatok formátuma. Előre DataFormats definiált formátumok megtekintése.

data

Object

A Object hozzáadni kívánt adatokat jelképező.

Kivételek

ExternalException

A vágólap nem törölhető. Ez általában akkor fordul elő, ha a vágólapot egy másik folyamat használja.

ThreadStateException

Az aktuális szál nem egyszálas lakás (STA) módban van. Adja hozzá az STAThreadAttribute alkalmazás metódusához Main .

ArgumentNullException

data az null.

Példák

Az alábbi példa ezt a tagot mutatja be.

// 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

Megjegyzések

Ha nem ismeri a célalkalmazás formátumát, ezzel a módszerrel több formátumban is tárolhatja az adatokat.

Az ezzel a módszerrel tárolt adatok a lekéréskor kompatibilis formátummá alakíthatók.

Ha egy adott formátumban szeretné lekérni az adatokat a vágólapról, először a ContainsData módszerrel állapítsa meg, hogy a vágólap tartalmaz-e ilyen formátumú adatokat, mielőtt beolvassa azokat a GetData módszerrel.

Note

A Clipboard osztály csak olyan szálakban használható, amelyek egyszálas szálapartman (STA) módra vannak beállítva. Az osztály használatához győződjön meg arról, hogy a Main metódus STAThreadAttribute attribútummal van megjelölve.

Lásd még

• DataFormats
• ContainsData(String)
• GetData(String)