Share via

Clipboard.SetData(String, Object) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Pano'yu temizler ve ardından verileri belirtilen biçimde ekler.

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)

Parametreler

format
String

Ayarlanacağı verilerin biçimi. Önceden tanımlanmış biçimler için bkz DataFormats .

data
Object

Object Eklenecek verileri temsil eden.

Özel durumlar

ExternalException

Pano temizlenemedi. Bu durum genellikle Pano başka bir işlem tarafından kullanıldığında oluşur.

ThreadStateException

Geçerli iş parçacığı tek iş parçacıklı daire (STA) modunda değil. öğesini STAThreadAttribute uygulamanızın yöntemine Main ekleyin.

ArgumentNullException

data, null değeridir.

Örnekler

Aşağıdaki örnekte bu üye gösterilmektedir.

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

Açıklamalar

Hedef uygulamanın biçimini bilmiyorsanız, bu yöntemi kullanarak verileri birden çok biçimde depolayabilirsiniz.

Bu yöntem kullanılarak depolanan veriler alındığında uyumlu bir biçime dönüştürülebilir.

Pano'dan belirli bir biçimde veri almak için, panoyu ContainsData yöntemiyle GetData almadan önce panonun bu biçimde veri içerip içermediğini belirlemek için yöntemini kullanın.

Not

Clipboard sınıfı yalnızca tek iş parçacığı dairesi (STA) moduna ayarlanmış iş parçacıklarında kullanılabilir. Bu sınıfı kullanmak için yönteminizin Main özniteliğiyle işaretlendiğinden STAThreadAttribute emin olun.

Şunlara uygulanır

Ayrıca bkz.