Clipboard.GetData(String) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Clipboard.cs

Dikkat

Clipboard.GetData(string) method is obsolete. Use Clipboard.TryGetData<T> methods instead.

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

public:
 static System::Object ^ GetData(System::String ^ format);

[System.Obsolete("`Clipboard.GetData(string)` method is obsolete. Use `Clipboard.TryGetData<T>` methods instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public static object? GetData(string format);

[<System.Obsolete("`Clipboard.GetData(string)` method is obsolete. Use `Clipboard.TryGetData<T>` methods instead.", false, DiagnosticId="WFDEV005", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
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.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ExternalException

Pano temizlenemiyor. 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. STAThreadAttribute öğesini 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.

Note

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 Main yönteminizin STAThreadAttribute özniteliğiyle işaretlendiğinden emin olun.

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

Ayrıca bkz.

• Object
• DataFormats
• ContainsData(String)
• SetData(String, Object)