Clipboard.SetDataObject Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Slaat een opgegeven gegevensobject op het klembord van het systeem op.
Overloads
| Name | Description |
|---|---|
| SetDataObject(Object) |
Hiermee wordt een opgegeven niet-permanent gegevensobject op het klembord van het systeem geplaatst. |
| SetDataObject(Object, Boolean) |
Hiermee plaatst u een opgegeven gegevensobject op het klembord van het systeem en accepteert u een Booleaanse parameter die aangeeft of het gegevensobject op het Klembord moet blijven staan wanneer de toepassing wordt afgesloten. |
SetDataObject(Object)
Hiermee wordt een opgegeven niet-permanent gegevensobject op het klembord van het systeem geplaatst.
public:
static void SetDataObject(System::Object ^ data);[System.Security.SecurityCritical]
public static void SetDataObject(object data);public static void SetDataObject(object data);[<System.Security.SecurityCritical>]
static member SetDataObject : obj -> unitstatic member SetDataObject : obj -> unitPublic Shared Sub SetDataObject (data As Object)Parameters
- data
- Object
Een gegevensobject (een object dat wordt geïmplementeerd IDataObject) om op het klembord van het systeem te plaatsen.
- Kenmerken
Uitzonderingen
data is null.
Er is een fout opgetreden bij het openen van het Klembord. De details van de uitzondering bevatten een HResult die de specifieke fout identificeert. Zie ErrorCode.
Opmerkingen
Standaard worden gegevens op het klembord SetDataObject van het systeem automatisch gewist vanaf het Klembord wanneer de toepassing wordt afgesloten.
Note
Het standaardgedrag van het wissen van het Klembord bij het afsluiten van toepassingen kan afwijken van andere implementaties, waardoor gegevens op het Klembord bij het afsluiten van de toepassing kunnen blijven in plaats van deze standaard te wissen. Gebruik de SetDataObject overbelasting en geef de copy parameter op alsof true u niet wilt dat gegevens worden gewist vanaf het Klembord bij het afsluiten van de toepassing.
DataObject biedt een eenvoudige implementatie van de IDataObject interface.
Zie ook
Van toepassing op
SetDataObject(Object, Boolean)
Hiermee plaatst u een opgegeven gegevensobject op het klembord van het systeem en accepteert u een Booleaanse parameter die aangeeft of het gegevensobject op het Klembord moet blijven staan wanneer de toepassing wordt afgesloten.
public:
static void SetDataObject(System::Object ^ data, bool copy);[System.Security.SecurityCritical]
public static void SetDataObject(object data, bool copy);public static void SetDataObject(object data, bool copy);[<System.Security.SecurityCritical>]
static member SetDataObject : obj * bool -> unitstatic member SetDataObject : obj * bool -> unitPublic Shared Sub SetDataObject (data As Object, copy As Boolean)Parameters
- data
- Object
Een gegevensobject (een object dat wordt geïmplementeerd IDataObject) om op het klembord van het systeem te plaatsen.
- copy
- Boolean
true om de gegevens op het klembord van het systeem te laten staan wanneer de toepassing wordt afgesloten; false om de gegevens van het klembord van het systeem te wissen wanneer de toepassing wordt afgesloten.
- Kenmerken
Uitzonderingen
data is null.
Er is een fout opgetreden bij het openen van het Klembord. De details van de uitzondering bevatten een HResult die de specifieke fout identificeert. Zie ErrorCode.
Voorbeelden
In het volgende voorbeeld ziet u het gebruik van deze methode.
// 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.";
// The example will enable auto-conversion of data for this data object.
bool autoConvert = true;
// Create a new data object, specifying the data format, data to encapsulate, and enabling
// auto-conversion services.
DataObject data = new DataObject(DataFormats.UnicodeText, (Object)textData, autoConvert);
// If the data to be copied is supposed to be persisted after the application ends,
// then set the second parameter of SetDataObject to true.
if(persistentData)
{
// Place the persisted data on the clipboard.
Clipboard.SetDataObject(data, true);
}
else
{
// Place the non-persisted data on the clipboard.
Clipboard.SetDataObject(data, false);
}
// If you keep a copy of the source data object, you can use the IsCurrent method to see if
// the data object is still on the clipboard.
bool isOriginalDataObject = Clipboard.IsCurrent(data);
' 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."
' The example will enable auto-conversion of data for this data object.
Dim autoConvert As Boolean = True
' Create a new data object, specifying the data format, data to encapsulate, and enabling
' auto-conversion services.
Dim data As New DataObject(DataFormats.UnicodeText, CType(textData, Object), autoConvert)
' If the data to be copied is supposed to be persisted after the application ends,
' then set the second parameter of SetDataObject to true.
If persistentData Then
' Place the persisted data on the clipboard.
Clipboard.SetDataObject(data, True)
Else
' Place the non-persisted data on the clipboard.
Clipboard.SetDataObject(data, False)
End If
' If you keep a copy of the source data object, you can use the IsCurrent method to see if
' the data object is still on the clipboard.
Dim isOriginalDataObject As Boolean = Clipboard.IsCurrent(data)
Opmerkingen
DataObject biedt een eenvoudige implementatie van de IDataObject interface. IsCurrent bepaalt het gegevensobject dat eerder op het klembord is geplaatst door de laatste SetDataObject aanroep.
