Clipboard.GetData(String) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Recupera dados em um formato especificado da Área de transferência.

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

public static object GetData (string format);

static member GetData : string -> obj

Public Shared Function GetData (format As String) As Object

Parâmetros

format

String

Uma cadeia de caracteres que especifica o formato dos dados a serem recuperados. Para um conjunto de formatos de dados predefinidos, consulte a classe DataFormats.

Retornos

Object

Um objeto que contém os dados no formato especificado ou null se os dados não estiverem disponíveis no formato especificado.

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo a seguir demonstra o uso desse método.

// After this line executes, IsHTMLDataOnClipboard will be true if
// HTML data is available natively on the clipboard; if not, it 
// will be false.
bool IsHTMLDataOnClipboard = Clipboard.ContainsData(DataFormats.Html);

// If there is HTML data on the clipboard, retrieve it.
string htmlData;
if(IsHTMLDataOnClipboard)
{

    htmlData = Clipboard.GetText(TextDataFormat.Html);
}

' After this line executes, IsHTMLDataOnClipboard will be true if
' HTML data is available natively on the clipboard; if not, it 
' will be false.
Dim IsHTMLDataOnClipboard As Boolean = Clipboard.ContainsData(DataFormats.Html)

' If there is HTML data on the clipboard, retrieve it.
Dim htmlData As String
If IsHTMLDataOnClipboard Then

    htmlData = Clipboard.GetText(TextDataFormat.Html)

End If

Confira também

• GetAudioStream()
• GetDataObject()
• GetFileDropList()
• GetImage()
• GetText
• ContainsData(String)
• SetData(String, Object)
• DataFormats