Clipboard.GetText Método

Definição

Recupera dados de texto da Área de Transferência.

Sobrecargas

GetText()

Recupera dados de texto da Área de Transferência no formato Text ou UnicodeText, dependendo do sistema operacional.

GetText(TextDataFormat)

Recupera os dados de texto da Área de Transferência no formato indicado pelo valor TextDataFormat especificado.

GetText()

Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs

Recupera dados de texto da Área de Transferência no formato Text ou UnicodeText, dependendo do sistema operacional.

public static string GetText ();

Retornos

Os dados de texto da Área de Transferência ou Empty se a Área de Transferência não contiver dados no formato Text ou UnicodeText, dependendo do sistema operacional.

Exceções

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

Exemplos

O exemplo a seguir demonstra uma sobrecarga do GetText método semelhante a essa sobrecarga.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

Comentários

Esse método retorna dados de texto no UnicodeText formato no Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. Caso contrário, esse método retornará dados de texto no Text formato .

Use o ContainsText método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com esse método.

Use o SetText método para adicionar dados de texto à Área de Transferência.

Nota

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

GetText(TextDataFormat)

Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs

Recupera os dados de texto da Área de Transferência no formato indicado pelo valor TextDataFormat especificado.

public static string GetText (System.Windows.Forms.TextDataFormat format);

Parâmetros

format
TextDataFormat

Um dos valores de TextDataFormat.

Retornos

Os dados de texto da Área de Transferência ou Empty se a Área de Transferência não contiver dados no formato especificado.

Exceções

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

format não é um valor TextDataFormat válido.

Exemplos

O exemplo a seguir demonstra esse membro.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

Comentários

Use o ContainsText método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com esse método.

Use o SetText método para adicionar dados de texto à Área de Transferência.

Nota

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9