Clipboard.SetText Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Cancella il contenuto degli Appunti e vi aggiunge dati di testo.

Overload

SetText(String)	Cancella il contenuto degli Appunti e aggiunge dati di testo nel formato Text o UnicodeText, in base al sistema operativo.
SetText(String, TextDataFormat)	Cancella il contenuto degli Appunti e aggiunge dati di testo nel formato indicato dal valore TextDataFormat specificato.

SetText(String)

Cancella il contenuto degli Appunti e aggiunge dati di testo nel formato Text o UnicodeText, in base al sistema operativo.

public:
 static void SetText(System::String ^ text);

public static void SetText (string text);

static member SetText : string -> unit

Public Shared Sub SetText (text As String)

Parametri

text

String

Testo da aggiungere agli Appunti.

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.

ArgumentNullException

text è null o Empty.

Esempio

Nell'esempio SetText 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 aggiunge 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 aggiunge dati di testo nel Text formato.

Per recuperare i dati di testo dagli Appunti, usare innanzitutto il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con il GetText metodo .

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
• GetText

SetText(String, TextDataFormat)

Cancella il contenuto degli Appunti e aggiunge dati di testo nel formato indicato dal valore TextDataFormat specificato.

public:
 static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);

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

static member SetText : string * System.Windows.Forms.TextDataFormat -> unit

Public Shared Sub SetText (text As String, format As TextDataFormat)

Parametri

text

String

Testo da aggiungere agli Appunti.

format

TextDataFormat

Uno dei valori di TextDataFormat.

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.

ArgumentNullException

text è null o Empty.

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

Per recuperare i dati di testo dagli Appunti, usare innanzitutto il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con il GetText metodo .

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
• GetText