Clipboard.SetDataObject Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationCore.dll

Belirtilen veri nesnesini sistem Panosu'nda depolar.

Aşırı Yüklemeler

SetDataObject(Object)	Belirtilen kalıcı olmayan bir veri nesnesini sistem Panosuna yerleştirir.
SetDataObject(Object, Boolean)	Belirtilen veri nesnesini sistem Panosu'na yerleştirir ve uygulamadan çıkıldığında veri nesnesinin Pano'da bırakılıp bırakılmayacağını belirten bir Boole parametresi kabul eder.

SetDataObject(Object)

Belirtilen kalıcı olmayan bir veri nesnesini sistem Panosuna yerleştirir.

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

static member SetDataObject : obj -> unit

Public Shared Sub SetDataObject (data As Object)

Parametreler

data

Object

Sistem Panosuna yerleştirecek bir veri nesnesi (uygulayan IDataObjectbir nesne).

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

ArgumentNullException

data, null değeridir.

ExternalException

Panoya erişilirken bir hata oluştu. Özel durum ayrıntıları, belirli bir hatayı tanımlayan bir HResult içerir; bkz ErrorCode. .

Açıklamalar

Varsayılan olarak, ile sistem Panosu'na SetDataObject yerleştirilen veriler, uygulamadan çıkıldığında Pano'dan otomatik olarak temizlenir.

Not

Uygulama çıkışında Pano'nun temizlenmesinin varsayılan davranışı diğer uygulamalardan farklı olabilir ve bu da verileri varsayılan olarak temizlemek yerine uygulama çıkışında Pano'da bırakabilir. SetDataObject Aşırı yüklemeyi kullanın ve uygulama çıkışında copy Pano'dan verilerin temizlenmesini istemiyorsanız parametresini true belirtin.

DataObject arabiriminin IDataObject temel bir uygulamasını sağlar.

Ayrıca bkz.

• GetDataObject()

SetDataObject(Object, Boolean)

Belirtilen veri nesnesini sistem Panosu'na yerleştirir ve uygulamadan çıkıldığında veri nesnesinin Pano'da bırakılıp bırakılmayacağını belirten bir Boole parametresi kabul eder.

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

static member SetDataObject : obj * bool -> unit

Public Shared Sub SetDataObject (data As Object, copy As Boolean)

Parametreler

data

Object

Sistem Panosuna yerleştirecek bir veri nesnesi (uygulayan IDataObjectbir nesne).

copy

Boolean

true uygulamadan çıktığında verileri sistem Panosu'nda bırakmak için; false uygulamadan çıkıldığında sistem Panosu'ndan verileri temizlemek için.

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

ArgumentNullException

data, null değeridir.

ExternalException

Panoya erişilirken bir hata oluştu. Özel durum ayrıntıları, belirli bir hatayı tanımlayan bir HResult içerir; bkz ErrorCode. .

Örnekler

Aşağıdaki örnekte bu yöntemin kullanımı gösterilmektedir.

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

Açıklamalar

DataObject arabiriminin IDataObject temel bir uygulamasını sağlar. IsCurrent , daha önce son SetDataObject çağrıyla panoya yerleştirilen veri nesnesini belirler.

Ayrıca bkz.

• GetDataObject()