Clipboard.SetText Método

Definição

Limpa a Área de Transferência e adiciona dados de textos a ela.

Sobrecargas

SetText(String)

Limpa a área de transferência e, em seguida, adiciona dados de texto no formato Text ou UnicodeText, dependendo do sistema operacional.

SetText(String, TextDataFormat)

Limpa a Área de Transferência e adiciona dados de texto no formato indicado pelo valor TextDataFormat especificado.

SetText(String)

Limpa a área de transferência e, em seguida, adiciona dados de texto no formato Text ou UnicodeText, dependendo do sistema operacional.

public static void SetText (string text);

Parâmetros

text
String

O texto a ser adicionado à Área de Transferência.

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.

text é null ou Empty.

Exemplos

O exemplo a seguir demonstra uma sobrecarga do SetText 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 adiciona 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 adiciona dados de texto no Text formato .

Para recuperar dados de texto da Área de Transferência, primeiro use o ContainsText método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com o GetText método .

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

SetText(String, TextDataFormat)

Limpa a Área de Transferência e adiciona dados de texto no formato indicado pelo valor TextDataFormat especificado.

public static void SetText (string text, System.Windows.Forms.TextDataFormat format);

Parâmetros

text
String

O texto a ser adicionado à Área de Transferência.

format
TextDataFormat

Um dos valores de TextDataFormat.

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.

text é null ou Empty.

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

Para recuperar dados de texto da Área de Transferência, primeiro use o ContainsText método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com o GetText método .

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