Clipboard.GetData(String) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 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
Pano temizlenemedi. Bu durum genellikle Pano başka bir işlem tarafından kullanıldığında oluşur.
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.