Clipboard.GetText Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

public:
 static System::String ^ GetText();

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Restituisce

String

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

Eccezioni

ExternalException

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

ThreadStateException

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.

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

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

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

• TextDataFormat
• ContainsText
• SetText

GetText(TextDataFormat)

Origine:

Clipboard.cs

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

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);

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

static member GetText : System.Windows.Forms.TextDataFormat -> string

Public Shared Function GetText (format As TextDataFormat) As String

Parametri

format

TextDataFormat

Uno dei valori di TextDataFormat.

Restituisce

String

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

Eccezioni

ExternalException

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

ThreadStateException

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

InvalidEnumArgumentException

format non è un valore valido di TextDataFormat.

Esempio

Nell'esempio seguente viene illustrato questo 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;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

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

• TextDataFormat
• ContainsText
• SetText