Clipboard.GetText Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mengambil data teks dari Clipboard.

Overload

GetText()	Mengambil data teks dari Clipboard dalam Text format atau UnicodeText , tergantung pada sistem operasi.
GetText(TextDataFormat)	Mengambil data teks dari Clipboard dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .

GetText()

Mengambil data teks dari Clipboard dalam Text format atau UnicodeText , tergantung pada sistem operasi.

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

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Mengembalikan

String

Data teks Clipboard atau Empty jika Clipboard tidak berisi data dalam Text format atau UnicodeText , tergantung pada sistem operasi.

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.

Contoh

Contoh berikut menunjukkan kelebihan beban GetText 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 mengembalikan data teks dalam UnicodeText format pada Windows XP Home Edition, Windows XP Professional, Windows Server 2003 dan Windows 2000. Jika tidak, metode ini mengembalikan data teks dalam Text format .

ContainsText Gunakan metode untuk menentukan apakah Clipboard berisi data teks sebelum mengambilnya dengan metode ini.

SetText Gunakan metode untuk menambahkan data teks ke Clipboard.

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

GetText(TextDataFormat)

Mengambil data teks dari Clipboard dalam format yang ditunjukkan oleh nilai yang ditentukan TextDataFormat .

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

Parameter

format

TextDataFormat

Salah TextDataFormat satu nilai.

Mengembalikan

String

Data teks Clipboard atau Empty jika Clipboard tidak berisi data dalam format yang ditentukan.

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.

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

ContainsText Gunakan metode untuk menentukan apakah Clipboard berisi data teks sebelum mengambilnya dengan metode ini.

SetText Gunakan metode untuk menambahkan data teks ke Clipboard.

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