Clipboard.GetText Metodo

Definizione

Recupera dati di testo dagli Appunti.

Overload

GetText()

Recupera dati di testo dagli Appunti nel formato Text o UnicodeText, in base al sistema operativo.

GetText(TextDataFormat)

Recupera dati di testo dagli Appunti nel formato indicato dal valore TextDataFormat specificato.

GetText()

Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs

Recupera dati di testo dagli Appunti nel formato Text o UnicodeText, in base al sistema operativo.

C#
public static string GetText();

Restituisce

Dati di testo degli Appunti o Empty se gli Appunti non contengono dati nel formato Text o UnicodeText, in base al sistema operativo.

Eccezioni

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

Esempio

Nell'esempio GetText seguente viene illustrato un overload del metodo simile a questo overload.

C#
// 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;
}

Commenti

Questo metodo restituisce dati di testo nel UnicodeText formato in Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. In caso contrario, questo metodo restituisce dati di testo nel Text formato.

Usare il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con questo metodo.

Usare il SetText metodo per aggiungere dati di testo agli Appunti.

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.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)

Origine:
Clipboard.cs
Origine:
Clipboard.cs
Origine:
Clipboard.cs

Recupera dati di testo dagli Appunti nel formato indicato dal valore TextDataFormat specificato.

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

Parametri

format
TextDataFormat

Uno dei valori di TextDataFormat.

Restituisce

Dati di testo degli appunti o Empty se gli Appunti non contengono dati nel formato specificato.

Eccezioni

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

format non è un valore valido di TextDataFormat.

Esempio

Nell'esempio seguente viene illustrato questo membro.

C#
// 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;
}

Commenti

Usare il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con questo metodo.

Usare il SetText metodo per aggiungere dati di testo agli Appunti.

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.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