Clipboard.SetText Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menghapus Clipboard lalu menambahkan data teks ke dalamnya.

Overload

SetText(String)	Menghapus Clipboard lalu menambahkan data teks dalam Text format atau UnicodeText , tergantung pada sistem operasi.
SetText(String, TextDataFormat)	Menghapus Clipboard lalu menambahkan data teks dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .

SetText(String)

Menghapus Clipboard lalu menambahkan data teks dalam Text format atau UnicodeText , tergantung pada sistem operasi.

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)

Parameter

text

String

Teks yang akan ditambahkan ke Clipboard.

Pengecualian

ExternalException

Papan klip tidak dapat dibersihkan. Ini biasanya terjadi ketika Clipboard sedang digunakan oleh proses lain.

ThreadStateException

Utas saat ini tidak dalam mode apartemen berulir tunggal (STA). Tambahkan ke STAThreadAttribute metode aplikasi Main Anda.

ArgumentNullException

text adalah null atau Empty.

Contoh

Contoh berikut menunjukkan kelebihan beban SetText metode yang mirip dengan kelebihan beban ini.

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

Keterangan

Metode ini menambahkan data teks dalam UnicodeText format pada Windows XP Home Edition, Windows XP Professional, Windows Server 2003 dan Windows 2000. Jika tidak, metode ini menambahkan data teks dalam Text format .

Untuk mengambil data teks dari Clipboard, pertama-tama gunakan ContainsText metode untuk menentukan apakah Clipboard berisi data teks sebelum mengambilnya dengan GetText metode .

Catatan

Kelas Clipboard hanya dapat digunakan dalam utas yang diatur ke mode apartemen utas tunggal (STA). Untuk menggunakan kelas ini, pastikan metode Anda Main ditandai dengan STAThreadAttribute atribut .

Lihat juga

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Menghapus Clipboard lalu menambahkan data teks dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .

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)

Parameter

text

String

Teks yang akan ditambahkan ke Clipboard.

format

TextDataFormat

Salah TextDataFormat satu nilai.

Pengecualian

ExternalException

Papan klip tidak dapat dibersihkan. Ini biasanya terjadi ketika Clipboard sedang digunakan oleh proses lain.

ThreadStateException

Utas saat ini tidak dalam mode apartemen berulir tunggal (STA). Tambahkan ke STAThreadAttribute metode aplikasi Main Anda.

ArgumentNullException

text adalah null atau Empty.

InvalidEnumArgumentException

format bukan nilai yang valid TextDataFormat .

Contoh

Contoh berikut menunjukkan anggota ini.

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

Keterangan

Untuk mengambil data teks dari Clipboard, pertama-tama gunakan ContainsText metode untuk menentukan apakah Clipboard berisi data teks sebelum mengambilnya dengan GetText metode .

Catatan

Kelas Clipboard hanya dapat digunakan dalam utas yang diatur ke mode apartemen utas tunggal (STA). Untuk menggunakan kelas ini, pastikan metode Anda Main ditandai dengan STAThreadAttribute atribut .

Lihat juga

• TextDataFormat
• ContainsText
• GetText