Share via

Clipboard.GetData(String) Yöntem

  • Başvuru

Tanım

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

Pano'dan belirtilen biçimde veri alır.

public:
 static System::Object ^ GetData(System::String ^ format);
public static object GetData (string format);
public static object? GetData (string format);
static member GetData : string -> obj
Public Shared Function GetData (format As String) As Object

Parametreler

format
String

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

Döndürülenler

Object

Object Pano verilerini temsil eden veya null Pano'da belirtilen format veya bu biçime dönüştürülebilecek herhangi bir veri yoksa.

Ö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.

Ö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

ContainsData Bu yöntemle almadan önce Pano'da belirtilen biçimde veya uyumlu bir biçimde veri içerip içermediğini belirlemek için yöntemini kullanın.

Bu yöntem verileri belirtilen biçimde bulamazsa, verileri biçime dönüştürmeye çalışır. Veriler belirtilen biçime dönüştürülemiyorsa veya veriler otomatik dönüştürme olarak ayarlandıysa false, bu yöntem döndürür null.

Not

Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.

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.

Pano'ya SetData belirli bir biçimde veri eklemek için yöntemini kullanın.

Şunlara uygulanır

Ayrıca bkz.